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Background of the Invention 

This invention relates generally to human/computer interfaces, and more 
particularly to human/computer interfaces with force feedback that can operate over a 
network. 

The Internet has, of late, become extremely popular. While the use of the Internet 
has been prevalent for many years now, its use has been limited by the arcane and 
difficult commands required to access the various computers on the network. To address 
this problem, a protocol known as the " World Wide Web" or "WWW" was developed 
to provide an easier and user-friendlier interface for the Internet. With the World Wide 
Web, an entity having a domain name creates a "web page" or "page" which can 
provide information and, to a limited degree, some interactivity. 

A computer user can "browse", i.e. navigate around, the WWW by utilizing a 
suitable web browser and a network gateway (e.g., an Internet Service Provider (ISP)). 
Currently, popular web browsers, include Netscape® Navigator® made by Netscape 
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Corporation of Mountain View, California, and Internet Explorer made by Microsoft® 
Corporation of Redmond, Washington. A web browser allows a user to specify or search 
for a web page on the WWW, and then retrieves and displays web pages on the user's 
computer screen. 

The Internet is based upon a transmission protocol known as "Transmission 
Control Protocol/Internet Protocol" (or "TCP/IP" for short), which sends "packets" of 
data between a host machine, e.g. a server computer on the Internet, and a client machine, 
e.g. a user's personal computer connected to the Internet. The WWW is an Internet 
interface protocol which is supported by the same TCP/IP transmission protocol. 
Intranets are private networks based upon Internet standards; since they adhere to Internet 
standards, can often use the same web browser software and web server software as are 
used on the Internet. 

A web page typically includes static images, animated images (e.g. video), and/or 
text. The images and text are specified in a "HyperText Mark-up Language" ("HTML") 
file that is sent from the web server to the client machine. This HTML file is parsed by 
the web browser in order to display the text and images on the display of the client 
machine. Other standardized languages or protocols are also being developed for use 
with the Internet and the World Wide Web. For example, the Virtual Reality Modeling 
Language (VRML) is used to provide visual virtual 3-D environments and allow one or 
many users to navigate through and interact as " avatars" in such an environment using a 
web browser or other software on a client computer system. 

Furthermore, additional functionality may be provided in web pages with 
information downloaded over the WWW in the form of scripts or programs. Scripting, 
typically in the form of VBScript or JavaScript, allows a series of instructions to be 
performed on the client computer once the instructions have been downloaded in a web 
page. Programs can be provided in such standard languages as Visual Basic, C++, or 
currently in the form of Java "applets" or ActiveX® controls. Java includes a platform- 
independent interpreter running on the client machine that executes downloaded applets 
within web pages or other programs, e.g., to display animated images, retrieve data over 
the WWW, output feedback to the user, or perform operating system tasks. ActiveX 
controls similarly execute on the client computer once the program instructions are 
resident on the client. ActiveX controls are programmable objects that can be embedded 
into Web pages and may be written in any (platform-specific) language. Java and 
ActiveX controls can add functionality to a Web page that would normally be difficult, or 
even impossible, using HTML or scripting languages. ActiveX controls can also be 
controlled with a scripting language. Alternatively, functionality can be added to a web 
page through the use of "plug-ins", which are application programs running in 
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conjunction with certain web browsers to parse plug-in-specific code in the web page 
which the browser cannot understand. 

Other WWW-related functionality includes Dynamic HTML. Dynamic HTML is 
a set of features currently incorporated in browsers such as Microsoft Internet Explorer 
that enable authors to dynamically change the rendering and content of an HTML 
document. Using Dynamic HTML, a content developer or programmer can access the 
attributes of a document's contents or objects (such as an object's position on the page 
and type). In addition, event messages are generated when a user interacts with the web 
page content (such as when a user clicks on a graphical button image). The features of 
Dynamic HTML can be elicited through the use of VBScript or JavaScript scripts 
embedded in a Web page or programmatically through Visual Basic or C++. 

The Internet and the WWW also permit sound data to be transmitted over the 
Internet. For example, references to sound files can be embedded in HTML pages and 
can be played by the web browser. Data "packets" coded in TCP/IP format can also be 
sent from one client machine to another over the Internet to transmit sound data. This 
last-mentioned technique forms the basis for Internet telephony. 

While the transmission of visual images (both static and dynamic), text, and 
sound over the Internet is well-known, the transmission of other types of sensory data has 
not been well explored. In particular, the transmission of data over the Internet pertaining 
to the sense of touch and/or force has not been established. "Force feedback" allows a 
user to experience or " feel" tactile sensations as provided through computational 
information. Using computer-controlled actuators and sensors on a force feedback 
device, a variety of realistic sensations can be modeled and experienced by the user. This 
useful and highly immersive sensory modality for interacting with the Internet has hereto 
been unavailable. 

In addition, there needs to be tools to allow web page authors to quickly and 
easily add forces to web page content or adjust/modify existing forces as desired. Such 
tools should preferably allow an author or user to intuitively include forces in web pages 
without needing a knowledge of force feedback instructions or programming constructs. 

In addition, the author should be provided with an intuitive way to design or adjust the 

i 

forces. Thus, a tool is needed for assisting the user, programmer or developer in 
intuitively and easily creating web pages and in setting force feedback characteristics to 
provide desired force sensations in web pages. 
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Summary of the Invention 



The present invention is related to the transmission/reception of information 
pertaining to force feedback to provide feel in transmitted information such as web pages. 
The force feedback provided by the methods and apparatus of the present invention 
enhance the sensory experience of the user to provide a richer, more interesting, and more 
enjoyable interaction with information received over networks. 

In one aspect of the present invention for providing force feedback over a 
network, information is received by a client machine over a network from a server 
machine. The client machine (typically a personal computer) has a visual display and a 
force feedback interface device. Force feedback interface devices can include force 
feedback mice, joysticks, finger cradles, trackballs, steering wheels, and yokes. The force 
feedback interface device includes sensors and actuators and preferably a local 
microprocessor for communicating with the client machine and controlling the actuators 
of the interface device. 

Several embodiments are disclosed in which forces are implemented based on the 
information received over the network. The disclosed embodiments emphasize the World 
Wide Web or the Internet as the network provided between client and server computers, 
where web page information received by the client is in HTML or other standard format 
and a web browser running on the client machine displays the web page. One 
embodiment provides authored force effects, which are effects particular to a web page 
that are customized for each web page object and are downloaded with the web page. 
The received web page information includes screen display information representing a 
visual layout of a web page and force feedback information related to providing a feel 
sensation. Input information from the interface device is used to position a cursor with 
respect to the visual layout of the web page. A force feedback signal is provided based 
upon the input information and the web page information, and the received force 
feedback information includes a call to a force feedback program running on the client 
machine that provides the force feedback signal. The force feedback signal is received by 
the interface device, which outputs computer-controlled physical force feedback to the 
user correlated with the visual layout of the web page. The force feedback program 
running on the client can be ActiveX control, a Java applet, a plug-in, etc. In one 
preferred embodiment, the ActiveX control is called by script instructions, e.g. in 
JavaScript, included in the received force feedback information. The script instructions 
can provide downloaded force effect parameters to the force feedback program to output 
a desired force effect. 
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In a different embodiment, generic force effects are implemented. Generic effects 
are applied uniformly to all web page objects of a particular type. A web page need not 
include force information to allow generic force effects to be applied to the web page 
content. Thus, a received web page includes screen display information representing web 
page objects. The client determines which web page objects are force web page objects 
to be associated with at least one generic force effect, where the force web page objects 
are of a predefined type. A generic force effect is assigned to each type of web page 
object as defined by effect information derived from the client machine. Generic force 
effects are output when a user-controlled cursor interacts with a force web page object. A 
force control program running on the client machine can detect whether the cursor is 
contacting one of the force web page objects and output the appropriate force feedback 
signals to the interface device. In another embodiment, a downloaded web page can be 
preprocessed before being displayed to add force feedback information to the web page. 
The client can perform the preprocessing, or a proxy server can preprocess the web page 
before sending the web page to the client. In other embodiments, both generic effects and 
authored effects can be provided for a particular web page. If both types of force effects 
are used, either type of force effect can be overridden by the other depending on user 
preferences. 

In another aspect of the present invention, a web page authoring interface is 
provided that includes the ability to add force sensations to a web page. The web page 
authoring interface is displayed on a display device of a computer and displays a web 
page including web page objects. Input from a user is received to the authoring interface 
and selects a web page object and a force effect to be associated with the selected web 
page object. A web page is output by the interface, including the web page objects and 
including force information to allow the force effect to be implemented when the web 
page is displayed by a client machine after being received from a server machine over a 
network. The authoring tool can include a force design interface for creating or 
modifying the force effect, or a separate force design interface can accessed. The force 
effects added to web page objects can also be experienced directly by the author during 
the design process. In one embodiment, the author is also able to spatially designate an 
area of a web page object to be associated with a selected force effect, e.g. a graphical 
mark or outline can designate sub-areas of an image or text to be associated with forces. 
In addition, the user can preferably associate sound data with a web page object, such that 
when said force effect is output, a sound is output to the user synchronized with the force 
effect. Finally, a predefined graphical identifier can be inserted into the web page to 
indicate to a user that the web page provides force effects, and which may also be a link 
that causes a linked force feedback resource web page to be downloaded. 
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The present invention provides several ways to implement force feedback over a 
network such as the World Wide Web. Embodiments included herein allow standard web 
pages without any force content to be assigned forces on a client machine including force 
feedback capability. In other embodiments, a web page author can include specific force 
effects in a web page to any desired level of customization. The described force feedback 
web page authoring tool allows force effects to be easily and quickly included in web 
pages to foster greater diversity and widespread use of feel in web pages. 

These and other advantages of the present invention will become apparent upon 
reading the following detailed descriptions and studying the various figures of the 
drawings. 
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Brief Description of the Drawings 



Fig. 1 is a pictorial representation of the Internet, a web server machine, and two 
client machines; 

Fig. 2 is a block-diagram of a client machine used in the present invention; 

Fig. 3 is a block-diagram of a force feedback system in accordance with the 
present invention; 

Fig. 4a is a perspective view of a preferred human/computer interface ("force 
feedback device" ) of the present invention; 

Fig. 4b is a perspective view of the mechanism of the force feedback device of 

Fig. 4a; 

Fig. 5 is a block diagram of a wide area network (WAN) based upon Internet 
TCP/IP protocol and supporting World Wide Web (WWW) HTML protocols in 
accordance with the present invention; 

Fig. 6 is an illustration of a web browser and an image displayed on a visual 
display of a client computer as generated from a downloaded HTML web page file; 

Fig. 7 is a flow-diagram illustrating a first embodiment of an embodiment using 
Dynamic HTML to provide force effects in web pages; 

Fig. 8 is a diagrammatic illustration of the coordinate frames provided in Dynamic 
HTML; 

Fig. 9 is a diagrammatic illustration of coordinates used in a transformation to 
obtain screen coordinates of an object; 

. Fig. 10 is a flow-diagram of illustrating a second embodiment of an embodiment 
using Dynamic HTML to provide force effects in web pages; 

Figs. 1 la and 1 lb are diagrammatic illustrations of the two embodiments shown 
in Figures 7 and 10; 

Figs. 12, 13a, 13b, 14, and- 1.5 are illustrations of displayed web pages in which 
web page objects are associated with authored force effects using an ActiveX control; 
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Fig. 16 is a diagrammatic illustration showing a proxy server for providing 
preprocessing to web pages to add force effects; 

Fig. 17a and 17b are illustrations of embodiments of web page authoring 
applications of the present invention that includes force feedback editing functionality; 

Fig. 18 is a block diagram illustrating the web page authoring interface of the 
present invention and web pages produced by the authoring interface; 

Figs. 19a, 19b, and 19c are illustrations showing force effect editing interface 
examples which can be used in conjunction the authoring application of Figs. 17a- 17b; 

Figs. 20-22 illustrate a web page editor displaying an image in a web page and 
providing an outline function to add force effects to portions of the image; 

Figs. 23 and 24 illustrate the web page editor of Figs. 20-22 adding force effects 
to a different image; 

Fig. 25 is a diagrammatic illustration showing features of a first embodiment of 
the force feedback web page editor of the present invention; and 

Fig. 26 is a diagrammatic illustration showing features of a second embodiment of 
the force feedback web page editor of the present invention. 
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Detailed Description of the Preferred Embodiments 



In FIGURE 1, a network system 10 includes a wide area network (WAN) such as 
the Internet 12, and a number of computers or "machines" coupled to the Internet 12. 
5 For example, a first client machine 14, a second client machine 16, and a web server 
machine 18, are coupled to the Internet 12. 

As noted previously, both the Internet 12 and Intranets operate using the same 

TCP/IP protocols. This allows Intranets to use similar or the same server machine 

software and client machine software as are used in Internet 12 applications. The Internet 

10 12 includes a number of nodes 20 that are interconnected by data transmission media 22. 

These nodes are typically routers, switches, and other intelligent data transmission 

apparatus which route "packets" of TCP/IP information to the desired destination. In 

Q some instances, the nodes 20 comprise an Internet service provider (ISP) 20a which 

if% ' ■ 

in allows a client machine to access the "backbone" of the Internet. Alternatively, client 

1 4 1 5 machines and web servers can be coupled directly into the backbone of the Internet. 

U1 
iil 

As noted previously, the present invention is directed to the implementation of 
force feedback over a network, such as the Internet 12. To provide a user of a client 
machine with the experience of force feedback, force feedback human/computer 
interfaces (hereafter "force feedback devices") 24 and 26 can be provided as part of the 
!-t 20 client machines 14 and 16, respectively. The client machines 14 and 16 are typically 
provided with computer video monitors 28 and 30 (which is one example of a "visual 
display"), respectively, which can display images II and 12, respectively. Preferably, 
forces developed by force feedback devices 24 and 26 are correlated with the images II 
and 12 of the client machines 14 and 16, respectively. 

25 The machines 14-18 are considered, in the language of the Internet, to be 

"resources," and each has its own unique Uniform Resource Locator or "URL." In one 
embodiment of the present invention, a client machine, such as client machine 14 or 16, 
sends a request for a "web page" residing on, for example, web server machine 18. This 
is accomplished by the client machine sending a connection request and a URL which 

30 specifies the address of the web page to the web server machine 18. The web server 
machine 18 then sends a web page 32 in HTML format back to the requesting client 
machine where it is "cached" in the memory (typically the RAM, hard disk, or a 
combination of the two) of the client machine. In this embodiment of the invention, the 
image on the video display of the client machine is generated from the HTML web page 

35 file cached on the client machine, and force feedback is provided to a user through the 
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force feedback device as he manipulates a user manipulable object of the force feedback 
device. The embodiments of the present invention can also be used with other collections 
of data or documents besides web pages. 

In another aspect of the present invention, a first client machine, such as client 
machine 14, and a second client machine, such as client machine 16, directly 
communicate force feedback commands to each other in standard TCP/IP protocol over 
the Internet 12. More particularly, client machine 14 can send force feedback and other 
information to the URL of the client machine 16, and the client machine 16 can send 
force feedback and other information in standard TCP/IP packets to the URL of the client 
machine 14. In this way, users of client machine 14 and client machine 16 can interact 
physically over the Internet 12. Of course, a server machine 18 can likewise directly 
communicate force feedback commands to a client machine 12 or 14, or all three 
machines can interact. 

In FIGURE 2, a "personal" computer 34 architecture that can be used for client 
machine 14 or client machine 16 is shown in block diagram form. It should be noted that 
a variety of machine architectures can be used to access the Internet 12, such as a PC 
compatible computer under the Windows or MS-DOS operating system, Macintosh 
personal computer, SUN or Silicon Graphics workstation, home video game systems 
(such as systems available from Nintendo, Sega, or Sony), "set top box", "network 
access computers", portable/handheld computers of all types, or any general-purpose 
computer. The particular architecture shown for the computer 34 is a typical personal or 
"PC" computer architecture. Web server machines can also have similar architectures, 
but are often more powerful "workstations" that, for example, operate under some 
variant of the UNIX® operating system. The Internet service providers 20a are likewise 
often UNIX-based computers or powerful personal computers running Windows NT®. 
The nodes 20 are most commonly routers built by Cisco Systems of San Jose, California. 
Client machine 14 or 16 can also take other forms, such as a television including or 
connected to a microprocessor for Internet access. Force feedback devices used with 
such client machines can be appropriate for the particular embodiment, e.g., a TV remote 
control used for internet browsing on the abovernentioned television can include force 
feedback functionality. 

The personal computer system 34 includes a microprocessor 36 clocked by a 
system clock CLK and which is coupled to a high speed or memory bus 38 and to a lower 
speed or I/O bus 40. The system RAM 42 and ROM 44 are typically coupled to the high 
speed memory bus, while various peripherals, such as the video display, hard disk drive, 
Internet interface (often either a modem or an Ethernet connection), and force feedback 
device, are typically coupled to the slower I/O bus. The microprocessor executes 
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programs stored in the various memories or other computer-readable medium of the 
computer 34 (RAM, ROM, hard disk, signal propagated by a carrier wave, etc.) to 
control, for example, the image display on the video display and the forces provided by 
the force feedback device. The manufacture and use of computers, such as personal 
5 computer 34, are weIl 7 known to those skilled in the art. 

In FIGURE 3, a client machine 46 in accordance with the present invention 
includes a personal computer system 48 and a force feedback human/computer interface 
or "force feedback device" 50. A user 52 can receive visual information 54 and auditory 
information 56 from the personal computer 48 and can manipulate the force feedback 
10 device 50 as indicated at 58a and 58b to provide input, e.g., to command a cursor location 
on a visual display or other provide other control information. In addition, the user 52 
can receive force feedback 60 from the force feedback device 50 to represent physical 
"feel" or force sensations. 



VZ The personal computer system 48 includes the microprocessor 36, the system 

\ zip 

15 clock 62, a video monitor 64 (which is one type of "visual display"), and an audio 
device 66. The system clock 62, as explained previously, provides a system clock signal 
CLK. to the microprocessor 36 and to other components of the personal computer system 
W 48. The display device 64 and the audio output device 66 are typically coupled to the I/O 

p bus 40 (not shown in this figure), 

yj 

20 In this preferred embodiment, the force feedback device 50 preferably includes a 

local microprocessor 68, a local clock 70, optional local memory 71 for the local 
llj microprocessor 68, a sensor interface 72, sensors 74, a user manipulatable object 76, 

"other" input interface 78, an actuator interface 80, a safety switch 82, and actuators 84 
which provide a force F to the object 76, and an optional power supply 86 to provide 
25 power for the actuator interface 80 and actuator 84. 

The microprocessor 36 of the personal computer system 48 is coupled for 
communication with the local microprocessor 68 of the force feedback device 50. This 
communication coupling can be through a serial port coupling 88 to the personal 
computer system. A preferred communication coupling the Universal Serial Bus (USB) 
30 of a personal computer, although an RS-232 serial bus, or other communication coupling 
(such as Firewire), a parallel bus, an Ethernet bus, or other types of interfaces or 
communication links can also be used. 

In use, the user 52 of the client machine 46 grasps the object 76 of the force 
feedback device 50 and manipulates (i.e. exerts a force to move or attempt to move) the 
35 object to cause a "pointer" icon (cursor) to move in the image displayed by the display 
device 64. This pointer icon typically takes the form of a small arrow, a pointing hand, or 
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the like. The sensor 75 senses the movement of the object 76 and communicates the 
movement to the local microprocessor 68 through the sensor interface 72. The local 
microprocessor 68 then communicates through communication coupling 88 to the 
microprocessor 36 to cause the microprocessor 36 to create a corresponding movement of 
the pointer icon on the image displayed upon the visual display 64. In some 
embodiments, the sensors 74 can communicate directly to microprocessor 36 without the 
use of local microprocessor 68. The user can also create other input, such as a "button 
click," through the other input 78 which are communicated to the microprocessor 36 by 
the local microprocessor 68 or directly, e.g., using a game port. 

If the pointer icon on the display device 64 is at a position (or time) that correlates 
to a desired force feedback to the user 52, the microprocessor 36 sends a force feedback 
command to the local microprocessor 68 over the serial port connection 88. The local 
microprocessor 68 parses this force feedback command and sends signals to the actuator 
interface 80 which causes the actuator 84 to create forces F on object 76, which are 
experienced by the user 52 as indicated at 60. The safety switch 82, sometimes referred 
to as a "deadman switch", blocks the signal from the actuator interface 80 if, for 
example, the user 52 is no longer grasping the object 76. In this way, the user 52 can 
interact with the client machine 46 in a visual, auditory, and tactile fashion. 

The hardware architecture described above is also described in co-pending U.S. 
patent 5,739,811, filed 11/28/95, the disclosure of which is incorporated herein by 
reference. The high level command protocol between the computer and the force 
feedback device is also described in U.S. patent 5,734,373, filed 12/1/95, the disclosure 
of which is incorporated lwein by reference. Force feedback as implemented in a 
graphical user interface is described in U.Si patent application serial no. 08/571,606, filed 
Dec. 13, 1995, and incorporated herein by reference. 

FIGURE 4a is a perspective view of a force feedback mouse interface system 90 
of the present invention, capable of providing input from the user to a host computer 
based on the user's manipulation of the mouse and capable of providing force feedback to 
the user of the mouse system in accordance with the present invention. Mouse system 90 
includes interface device 50 that includes a user manipulatable object or manipulandum 
36 and an interface 100, and host (client) computer 48. 

User manipulatable object (or "manipulandum") 36, in the described 
embodiment, is a mouse that is shaped so that a user's fingers or hand may comfortably 
grasp the object and move it in the provided degrees of freedom in physical space. For 
example, a user can move mouse 36 to correspondingly move a computer generated 
graphical object, such as a cursor or other image, in a graphical environment provided by 
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computer 48. The available degrees of freedom in which mouse 36 can be moved are 
determined from the interface 100, described below. In addition, mouse 36 preferably 
includes one or more buttons 102 to allow the user to provide additional commands to the 
computer system. 

5 It will be appreciated that a great number of other types of user manipulable 

objects can be used with the method and apparatus of the present invention in place of or 
v in addition to mouse 36. For example, such objects may include a sphere, as trackball, a 
puck, a joystick, a knob, a wheel, a dial, cubical-, cylindrical-, or other-shaped hand grips, 
a fingertip receptacle for receiving a finger or a stylus, a flat planar surface like a plastic 
10 card having a rubberized, contoured, and/or bumpy surface, a handheld remote control 
used for controlling web pages or other devices, pool cue, or other physical objects. 

Interface 100 is provided in housing 101 and interfaces mechanical and electrical 
I s * input and output between the mouse 36 and host computer 48 implementing the 

j-j application program, such as a GUI, simulation or game environment. Interface 100 

v£t 15 provides one or more degrees of freedom to mouse 36; in the preferred embodiment, two 
linear, planar degrees of freedom are provided to the mouse, as shown by arrows 104. In 
111 other embodiments, greater or fewer degrees of freedom can be provided, as well as 

'■ r * rotary degrees of freedom. For many applications, mouse 36 need only be moved in a 

very small workspace area. 



j ; 5 20 The interface 100 provides position information to computer 48 via bus 112, such 

q as a Universal Serial Bus (USB). In addition, computer 48 and/or interface 100 provide 

v4 force feedback signals to actuators coupled to interface 100, and the actuators generate 

forces on members of the mechanical portion of the interface 100 to provide forces on 
mouse 36 in provided or desired degrees of freedom. The user experiences the forces 
25 generated on the mouse 36 as realistic simulations of force sensations such as jolts, 
springs, textures, enclosures, circles, ellipses, grids, vibrations, "barrier" forces, and the 
like. The electronic portion of interface 100 may couple the mechanical portion of the 
interface to the host computer 48. Interface 100 preferably includes a local 
microprocessor 68 as described above. Mouse 36 is preferably supported and suspended 
30 above a grounded pad 1 10 by the mechanical portion of interface 100. 

Computer 48 is preferably a personal or other computer, workstation, or game 
console as described above. Computer 48 preferably implements one or more application 
programs ("applications") with which a user is interacting via mouse 36 and other 
peripherals, if appropriate, and which can include force feedback functionality. For 
35 example, one of the application programs is preferably a Web browser that implements 
HTML or VRML instructions. Herein, computer 48 may be referred as displaying 
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"graphical objects" or "objects." These objects are not physical objects, but are logical 
software unit collections of data and/or procedures that may be displayed as images by 
computer 48 on display screen 64, as is well known to those skilled in the art. Display 
device 64 can be included in host computer 48 and can be a standard display screen 
(LCD, CRT, etc.), 3-D goggles, or any other visual output device. 

As shown in Figure 4a, the host computer may have its own "screen frame" 118 
(or host frame) which is displayed on the display screen 64. In contrast, the mouse 36 has 
its own "device frame" (or local frame) 120 in which the mouse 36 is moved. In a 
position control paradigm, the position (or change in position) of a user-controlled 
graphical object, such as a cursor, in host frame 118 corresponds to a position (or change 
in position) of the mouse 36 in the local frame 120. 

FIGURE 4b is a perspective view of a preferred embodiment of the mechanical 
portion 108 of mouse device 50. Mechanical linkage 130 provides support for mouse 36 
and couples the mouse to a grounded surface 124, such as a tabletop or other support. 
Linkage 130 is, in the described embodiment, a 5-member (or "5-bar") linkage. Fewer 
or greater numbers of members in the linkage can be provided in alternate embodiments. 

Ground member 132 of the linkage 130 is a base for the support of the linkage and 
is coupled to or resting on a ground surface 124. The members of linkage 130 are 
rotatably coupled to one another through the use of rotatable pivots or bearing assemblies, 
all referred to as "bearings" herein. Base member 134 is rotatably coupled to ground 
member 132 by a grounded bearing 142 and can rotate about an axis A. Link member 
136 is rotatably coupled to base member 134 by bearing 144 and can rotate about a 
floating axis B, and base member 138 is rotatably coupled to ground member 132 by 
bearing 142 and can rotate about axis A. Link member 140 is rotatably coupled to base 
member 138 by bearing 146 and can rotate about floating axis C, and link member 140 is 
also rotatably coupled to link member 136 by bearing 148 such that link member 140 and 
link member 136 may rotate relative to each other about floating axis D. Mouse 36 is 
coupled to link members 136 and 140 by rotary bearing 148 and may rotate at least 
partially about axis D. 

Transducer system 150 is used to sense the position of mouse 36 in its workspace 
and to generate forces on the mouse 36. Transducer system 150 preferably includes 
sensors 152 and actuators 154. The sensors 152 collectively sense the movement of the 
mouse 36 in the provided degrees of freedom and send appropriate signals to the 
electronic portion of interface 100. Sensor 152a senses movement of link member 138 
about axis A, and sensor 152b senses movement of base member 134 about axis A. 
These sensed positions about axis A allow the determination of the position of mouse 36 
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using known constants such as the lengths of the members of linkage 130 and using well- 
known coordinate transformations. Sensors 152 are, in the described embodiment, 
grounded optical encoders that sense the intermittent blockage of an emitted beam. A 
grounded emitter/detector portion 156 includes an emitter that emits a beam which is 
5 detected by a grounded detector. A moving encoder disk portion or "arc" 158 is 
provided at the end of members 134 and 138 which each block the beam for the 
respective sensor in predetermined spatial increments and allows a processor to determine 
the position (and velocity) of the arc 158 and thus the members 134 and 138 by counting 
the spatial increments. 

10 Transducersystem 150 also preferably includes actuators 154 to transmit forces to 

mouse 36 in space,Ye., in two (or more) degrees of freedom of the user object. The 
bottom housing plate \ 57 of actuator 154a is rigidly coupled to ground member 132 (or 
> grounded surface 124)Vhich includes, e.g. a magnet, and a moving portion of actuator 
/ 154a (e.g. a wire coil) \s integrated into the base member 134. The actuator 154a 
15 transmits rotational forces\to base member 134 about axis A. The housing 157 of the 
grounded portion of actuatot 154b is coupled to ground member 132 or ground surface 
124 through the grounded housing of actuator 154b, and a moving portion (e.g. a coil) of 
actuator 154b is integrated inra base member 138. Actuator 154b transmits rotational 
forces to link member 138 about Wis A. The combination of these rotational forces about 
20 axis A allows forces to be transmitted to mouse 36 in all directions in the planar 
workspace provided by linkage 130\hrough the rotational interaction of the members of 
linkage 130. The operation of the electromagnetic actuators 154 is described in greater 
detail in co-pending applications serial\no. 08/881,691 and aforementioned 08/965,720. 
In other embodiments, other types of actuators, such as electrical DC motors, can be used. 
25 A different embodiment of a force feedback device can include flexure members to allow 
movement in provided degrees of freedom. \ 

In FIGURE 5, a conceptual representation of the network system 10 with force 
feedback includes a server machine 18, a client machine 14 provided with a force 
feedback device 24, and one or more additional client machines 16, each of which may be 

30 provided with additional force feedback devices 26 v As noted in this figure, the server 
machine is a computer or "processor" running, for example, the TCP/IP server software 
and is which is connected to the Internet. The client machine 14 includes a computer or 
"processor" running Internet browser software and force feedback driver software. The 
processor of the client machine is connected to the Internet and to the force feedback 

35 device 24. The force feedback device 24 has sensors and actuators so that it can track 
movement of the user manipulatable object, monitor for button presses and/or other 
ancillary input devices, and provide output force feedback sensations. The force 
feedback device 24 sends object tracking information to the client machine, and receives 
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force feedback commands from the client machine 14! The "additional client", such as 
client machine 16, also includes computers or "processors" running Internet browser 
software and force feedback driver software. The processors of these additional clients 
are also connected to the Internet and are connected to force feedback devices associated 
with that client. 

As noted in Fig. 5, a client machine 14 can send a data request to the server 
machine 18 and, in return, receive a web page including HTML instructions and/or other 
instructions for implementing a web page, e.g. Dynamic HTML instructions, JavaScript 
instructions, Java or ActiveX code, an embedded plug-in reference (such as the "IFF" 
extension described below), etc. For example, if an embedded IFF reference is used, the 
server must also have a modified configuration file which lets it know that .IFF is a valid 
MIME type. This modified file would be a SRM.CONF or other .CONF file, as will be 
appreciated by those skilled in the art. The client machine 14 then sends force feedback 
commands to the force feedback device 24 and receives tracking and button data from the 
force feedback device 24. Client machine 16 can likewise send a data request to the 
server machine 18 and receive an HTML file and/or other web page data or other 
document or collection of data. The client machine 16 can then interact with the force 
feedback device 26 by sending force feedback commands to the device 26 and by 
receiving tracking and button data from the force feedback device 26. 

In another embodiment, a forcerrelated application or control program running on 
the client machine 16 can check if any peripherals including force feedback functionality 
are connected to the client machine. For example, after downloading a web page having 
force effects, the client machine can first check whether a force feedback mouse is 
connected. If no mouse is connected, the client can check whether another force feedback 
peripheral, such as a force feedback joystick, is connected. If so, the client can enable the 
joystick to control the position of the cursor within the web page so that the user is able to 
experience the force effects associated with web page objects. Other force feedback 
peripherals can also be enabled for cursor control in a web page. The force-related 
application can perform the necessary adjustments to receive input from an absolute input 
device or a relative input device, as necessary, or from a "cursor control device" or a 
" gaming device" , etc. 

In addition to communicating with the server machine, the client machines can 
communicate directly with each other over the Internet using an Internet communication 
protocol. For example, client machine 14 can communicate with client machine 16 
through a TCP/IP connection. This is accomplished making the URL of the client 
machine 16 known to the client machine 14, and vice versa. In this fashion, direct 
communication between client machines can be accomplished without involving the 
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server machine 18. These connections can send force feedback information and other 
information to the other client machine. For example, a process on the client machine 16 . 
can send force feedback information over a TCP/IP Internet connection to the client 
machine 14, which will then generate a force feedback command to the force feedback 
device 24. When the user reacts to the force feedback at force feedback device 24, this 
information can be sent from client machine 14 to client machine 16 to provide force 
feedback to the user on force feedback device 26. 

As is well known to those skilled in the art, a client machine normally connects to 
another computer, such as a server or other client, over the Web by sending a connection 
request to the "host" of the desired URL. The host, in this example, is a server machine 
18 and the desired URL is the URL of the desired web page residing on the server 
machine 18. Alternatively, the desired web page can reside on another server or resource 
and be retrieved by server machine 1 8. In response to the connection request of step 150, 
the server machine 1 8 sends the HTML file representing the web page over the Internet to 
be received by the client machine. The HTML file includes a number of "components" 
which are typically commands* command fragments, instructions, and data which permit 
the display of the web page and other functionality. HTML components are parsed and 
interpreted (processed) as they are received, e.g., even before the entire HTML file is 
received at the client machine. Alternatively, the entire HTML file can be received 
before the processing begins. 

A HTML file typically includes a number of " components" which are parsed and 
interpreted as previously described. For example, an HTML file begins with a 
<HTML>command or "tag" to indicate the start of the HTML file, and a <BODY> tag 
to indicate that the body of the HTML file is beginning. Then, an arbitrary number of 
HTML commands are provided to, for example, display images of the web page on the 
video display of the client machine. The body of the HTML file is terminated by the 
</BODY> command, and the end of the HTML file is indicated with the </HTML> 
command, i.e. this command is the "eof ' command of the HTML file. 



Force Effects in Web pages 

There are many types of touch interaction that can be achieved in Web pages. 
The force sensation resulting from this interaction is known herein as a force effect or an 
"effect." Two main classes of tactile interaction with Web content described herein are 
"generic effects" and "authored effects," as described in greater detail below. These 
effects are applied to web page objects in the most common implementation. Herein, 
"web page objects" or "web objects" are any graphical objects (or regions) appearing on 
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a web page, such as images, text, buttons, or other standardized or custom objects. In 
some cases, a web page object may not actually appear on the web page when displayed, 
but may have an effect on how the web page is visually displayed or how force effects are 
output on the force feedback interface device. 

Generic effects and authored effects are preferably composed from a basic set of 
stock force effects. The stock effects include vector forces, vibrations, springs, textures, 
and others, as\described in Patent No. 5,825,308 and co-pending patent applications 
08/571,606, 08A747,841, 08/846,011 and 08/879,296, all incorporated by reference 
herein. Effects oKdiffering complexity can be provided as stock effects; for example, a 
primitive effect such as a simple vector force to be output in a specified direction at a 
specified magnitude \an be provided, or a more complex effect that includes multiple 
primitive effects can bfe provided. One particularly significant, more complex effect is 
the enclosure. An enclosure is a set of forces that occur only when the cursor is in or near 
a geometrically bounded (V enclosed") area of the screen. Enclosures can be associated 
with forces at their borders txs> attract the cursor to the inside of the bounded area, keep the 
cursor outside the bounded Vea, or attract the cursor to the border surrounding the 
bounded area. The enclosure may take a variety of shapes, for example rectangular or 
elliptical, and may also be associated with one or more other force effects when the 
cursor or pointer is positioned insioe the enclosure. Examples of force effects that can be 
provided and programmed are specified in the FEELit Application Programming 
Interface (API) from Immersion Coloration of San Jose, CA., detailed in patent 
application serial no. 08/970,953, filed l\/14/97, Docket no. 1MM1P035, entitled, "Force 
Feedback System Including Multi-Tasking Graphical Host Environment and Interface 
Device" and incorporated by reference herem. 

For example, a hyperlink ('Mink") is an input-sensitive area displayed on a web 
page which, when selected by the user, causes a " link action" in the web browser. Such 
link actions can include retrieving a different web page over the Web whose address is 
specified by the link and/or displaying that web page, causing a different section of the 
web page currently in memory to be displayed, retrieving data for an animation or other 
modification of the current web page, sending data to a server over the web, or other 
action either locally and/or involving data transfer over the WWW. Typically, one or 
more web objects on a web page are defined as hyperlinks, such as text,, an image, an 
animated image, an icon, or other object; such an object is referred to as a "link object" 
herein. The user typically selects a link by moving the mouse pointer over the link object 
and providing a command gesture such as clicking a mouse button. Alternatively, links 
might automatically be selected when the mouse pointer is moved over the link object, 
i.e., the interaction of pointer and link object is the command gesture in such a case. 
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An enclosure can be defined as the visual boundaries of a hyperlink object 
(enclosures can also be defined as a portion of an object or as a portion of the background 
to the web page). The forces of the enclosure can be used to "snap 11 the pointer to that 
link object, i.e., assist the pointer to move onto or "acquire" that link object. To the user, 
5 this might feel as if the link has a magnetic attraction. A text hyperlink, for example, is 
no longer purely discerned by the user by the text's appearance (usually color and/or 
underlining), but is also discerned by its feel. Generally, hyperlinks are some of the more 
interesting features of a Web page and are intended to stand out from the other web page 
content to inform the user that other content can be accessed from the displayed web 
10 page, e.g. hyperlinks are the areas on the web page where the location of the mouse 
pointer can cause a link event, while other areas on the web page may have no effect 
based on input from a mouse. The snap enclosure effect physically grabs the user's 
attention at a link using forces until the user pushes the user manipulatable object (such as 
{i* a mouse) hard away from the link object. Instead of interacting with unresponsive text, 

•jr 15 the enclosures constrain the user to the most important content on the web page that is 
gjj responsive to input from the mouse (e.g. a command gesture such as a button click). 

\ ¥ 

j ;S * In addition, some objects on the web page may be defined as a hyperlink, but 

l t 

there is no visual evidence to the user that these objects are links and can cause a link 
? action such as calling up a different web page. For instance, many graphical images are 

20 also hyperlinks, but this fact is not discernible visually; previously, the user had to move 
the pointer over the image, which would cause the appearance of the mouse pointer to 
change if the image were a link object (or cause a change in other displayed information). 
Hi By providing enclosure effects on hyperlinks, tactile cues are offered instead of or in 

addition to visual cues; these tactile cues are consistent with the user interface so the user 
25 easily understands their meaning. The user can more quickly determine which objects on 
a web page are links by using the tactile sense compared with the visual sense. Adding 
feel to web pages increases both the user's efficiency and the quality of their experience. 
Some studies have shown an 88% improvement in mouse targeting performance with 
over 1000 test subjects. 

30 Other objects on a web page besides hyperlinks may also be associated with 

forces such as the enclosure to assist acquiring the object. For example, standard GUI 
graphical objects such as text boxes, input buttons, radio buttons, checkboxes, icons, are 
readily adaptable to enclosures. In addition, the user can be constrained by enclosures to 
the input fields or the areas associated with frames. For example, an input field where the 

35 user must enter data such as a name, a credit card number, or click a drop down menu are 
prime areas which can be associated with enclosure "snap to" forces. Similarly, frames 
having particular objects of interest can be associated with enclosure effects. "Frames" 
are those areas of a web page which can be accessed, manipulated, scrolled, etc. 
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independently of other displayed areas (other frames) of the web page. For example, a 
frame on the left side of a web page often is used to display the main subject areas of the 
web page while the larger, main frame on the right displays the content of a selected one 
of those subject areas. 

Finally, an extra dimension of user experience can be added by invoking a "pop" 
or jolt force effect when the user clicks on a buttons, checkboxes, or other graphical 
object. A pop is a time based sensation as opposed to, e.g., an enclosure implemented as 
a snap sensation, which is a spatially based sensation. 

FIGURE 6 illustrates a web browser 200 such as Netscape Navigator in which 
displayed web page objects are associated with forces. For example, these force effects 
can be authored force effects using any of the authored effect embodiments described 
below. Control area 210 of the browser includes well known controls such as navigation 
buttons 212 and 214 and URL address field 216. The display area 230 has been provided 
with a number of web page objects to illustrate some of the concepts of the present 
invention. The force feedback device controls the position of a pointer icon (cursor) 240 
which can be caused to interact with the various web page objects. 

As an example, when the force feedback device is manipulated by the user to 
cause the pointer icon 240 to move within a "texture" region 242, force feedback 
commands can be created for the force feedback device to provide a desired " texture" to 
the force feedback device. For example,, the texture can feel "rough" to the user by 
causing the force feedback device to place forces on the user manipulatable object that 
emulate a rough or bumpy surface. In a region 244, a viscosity or "liquid" force 
feedback can be provided. With this form of force feedback, as the pointer icon is moved 
through field 244, a viscous "drag" force is emulated on the user manipulatable object as 
if the user object were moved through a thick liquid. In a region 246, inertial forces can 
be felt. Therefore, a pointer icon being moved through an "inertia" region would require 
relatively little or no force to move in a straight line, but would require greater forces to 
accelerate in a new direction or to be stopped. The inertial force sensations can be 
applied to the user manipulatable object and felt by the user. 

In a "keep out" region 248, the pointer image is prevented from entering the 
region. This is accomplished by creating a repulsive force on the user manipulatable 
object using a force feedback command to the force feedback device which prevents or 
inhibits the user from moving the user manipulatable object in a direction of the region 
248 when the pointer icon 240 contacts the periphery of the region 248. In contrast, a 
"snap-in" region 250 will pull a pointer icon 240 to a center 252 whenever the pointer 
icon engages the periphery of the snap-in region 250 and apply a corresponding attractive 
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force on Ihe user manipulatable object. A "spring" region 254 emulates a spring 
function such that a pointer icon moving into the spring region "compresses" a spring, 
which exerts a spring force on the user manipulatable object which opposes the 
movement of the pointer icon. A region 256 is a "Force To Left" region where the 
pointer icon within the region 256 is forced to the left side of the region and the user 
manipulatable object is forced in a corresponding direction as if influenced by some 
invisible magnetic force or gravitational force. A region 258 illustrates that regions can 
be of any size or shape and that within a region different force effects can be developed. 
In this example, within region 258 there is a texture core 260 surrounded by a vibration 
ring 262. Therefore, as the pointer icon 240 moves into the region 258, the user first 
experiences vibration from the ring 262, and then experiences a texture as the pointer icon 
moves within the core 260. 

The exemplary force feedback web page of Fig. 6 is also provided with several 
force feedback buttons. In a First button 264, the placement of the pointer icon 240 over 
the button and the pressing of a mouse button (i.e., a switch) on the mouse 36 to create a 
"button click", "button down", or simply a "button event" input, will then cause a 
"buzz" command to be sent to the force feedback device. The buzz command would, for 
example, cause a vibration force on the user manipulatable object. Similarly, the 
selection of the "jolt" button 266 will cause a jolting force (e.g., a short-duration pulse of 
force) to be provided at the force feedback device, and the pressing of the "detent" 
button 268 will cause a "detent" to be created for the force feedback device. By 
"detent" it is meant that the user manipulatable object will be controlled by the force 
feedback actuators such that it feels as if a mechanical-type detent exists at the position 
that the user manipulatable object was in when the detent button 268 was activated. 



Generic Effects 

Generic effects are force effects that are applied uniformly to all objects in a 
received document having a particular type. For example, in a received web page, web 
page objects of standard types include hyperlinks, images, text, text entry fields, tables, 
headings, image maps, marquees, buttons, check boxes, radio buttons, drop-down menus, 
or other standard web page objects. Different generic effects can also be applied to 
different characteristics of an object; for example, one effect is associated with bold text, 
while a different effect is associated with text having the color blue. Generic effects are 
achieved by defining a mapping between object types and feel sensations, where feel 
sensations are uniformly associated with particular types of web page objects and/or 
particular types of interactions (or "events") with objects. "Interactions" or "events" 
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may include clicking a mouse button when the pointer is positioned over the object, 
moving the pointer onto a link from above the link (e.g. as differing from moving the 
pointer onto the link from below the link), or any other cursor/object interaction defined 
by the developer or user. 

In a preferences file or other storage of the client machine, particular force effects 
are each mapped to a particular type of object provided in a web page (and/or GUI). 
Using generic effects, the same force effect is applied to all graphical objects of a 
particular type. For example, all hyperlinks on a page can be assigned with an enclosure 
having the same force characteristics (e.g., forces of the same magnitude), although the 
area enclosed by each enclosure on the page will vary with the size of the web page 
object with which it is associated. 

A major advantage of using generic effects is that the force effects are 
implemented exclusively on the client side of the network. Thus, the author/content 
developer of a web page does not need to specify any forces or force characteristics of the 
objects in the web page code itself. When the web page is received by the client 
computer, the force-enabling code implemented by the client associates the forces from 
the preferences file (or default forces) to each graphical object and outputs the forces as 
appropriate. This allows standard web pages that have no force effects in their code to be 
implemented as a force feedback web page on the client end, which allows a force 
feedback interface device to be used immediately without requiring special web pages 
tailored for force output. In other embodiments, a web page can include force feedback 
information for authored effects (described below), and generic effects can also be 
applied to web page objects not having any authored effects associated with them, or to 
override particular authored effects as desired by the user of the client. 

For example, the force magnitudes or directions associated with an enclosure are 
defined on the client computer. This enclosure is assigned to objects of a particular type, 
e.g. link objects. A different enclosure with different associated forces can be assigned to 
another type of object, such as a (non-link) image or an animation. The preferred 
embodiment allows the user to adjust the effects to suit their preferences. For example, 
one way to allow a user to assign forces is analogous to the approach applied to the color 
of a hyperlink object, where the web browser automatically assigns the hyperlink a color 
based on the user's preference but web authors can override those default colors as 
desired, e.g. to make the hyperlinks' color match the web page's color scheme. The user 
preferably is able to adjust the characteristics of generic effects using a central control 
panel, e.g., a control dialog box associated with their force feedback GUf preferences, or 
a dialog box associated with the web browser preferences. 
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In a different embodiment, different sets of generic effects can be provided which 
are associated with different web pages or different groups of web pages. For example, 
the user can specify a first set of generic effects in which snap enclosures are to be 
associated with link objects on the downloaded web page. This first set is to be 
5 associated with web pages of a particular type or origin, e.g. all web pages received from 
a particular URL or domain name will have objects assigned to the first set of effects on 
the client computer. Likewise, a second set of generic effects can be characterized by the 
user, e.g. assigns vibration forces to link objects. The second set of generic effects is 
assigned to web pages received from a different source or having a different 
10 characteristic. Alternatively, different generic effect sets can be provided by different 
web site providers, developers, companies. Thus, for example, Immersion Corporation 
can provide a generic effect set that the user can download and which will automatically 
be assigned to web pages that are downloaded from specified servers or locations on the 
WWW. (The specified locations can be designated in the generic effect set file, or 

^3 15 otherwise). The web browser (or a plug-in or script) can check for these specified 

17% locations when a web page is downloaded. 
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Authored Effects 



hj In contrast, authored effects are effects particular to a certain web page that are 

*'3 20 specified or modified by a content developer or other author and which can provide a 
p more rich, custom experience than generic effects can offer. For example, one or more 

HJ particular graphical objects on a web page can be assigned a different, customized force 

effect by an author (the " author" can be the creator/developer of the web page or the user 
on the client machine that receives the web page). Web page objects having the same 
25 type can be assigned different force effects. Authored effects can be used, for example, to 
intentionally correlate a particular, unique force with an object of a web page. Typically, 
at least part of the instructions governing the type and/or characteristics of an authored 
effect are included in the code of the web page that is downloaded by the client. Thus, 
standard non-force web pages do not include authored force effects (unless there is 
30 preprocessing done to the web page before it is displayed by the client, as described in 
greater detail below). 

Any standard force effect can be an authored effect, e.g. those feel sensations 
supported by the FEELit API from Immersion Corp. Alternatively, authored effects can 
be partially or completely customized to be specific to a desired interaction or display. 
35 One example of an authored effect is gravity toward a particular object. A gravity force 
is an attractive force that biases or actively attracts the mouse in a direction that causes 
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the mouse pointer to move toward a defined point of the desired object. For example, an 
author can use gravity to attract the mouse pointer towards advertisement image objects 
on. a web page. Many web sites are sponsored or supported by advertisers; such sites 
usually include web pages that disptay graphical hyperlinks to a sponsor's web site. 
Although the advertisement visuals (animations, etc.) can attract the attention of a site's 
visitor, an authored effect can physically attract the mouse toward the advertisement, 
forcing the user to acknowledge the advertisement's existence. However, not all the 
graphical images on the same web page may be desired to have a gravity effect, so that 
generic effects may not be suitable in this situation. In other examples, authored effects 
can enable users to feel the texture of clothing at a commercial Web site by providing a 
texture effect associated with a graphical clothing image, or to feel the forces of a falling 
ball at a physics education web site by providing a ball image that causes the desired 
forces when the pointer is moved in contact with the ball image. Authored effects allow 
an author to provide a "theme" of feel sensations in accordance with a theme or subject 
of a particular web page; for example, a vibration force effect can be associated with the 
links of a web site that gives information about earthquakes. 

Authored effects can be "dynamic," i.e., the behavior of the effect can change 
depending on the author's intent and a current state or other state of the Web page. In the 
gravitational advertisement example, the gravity can be turned off once the mouse cursor 
has reached the advertisement. Thus, the user's experience of the site will not be 
compromised after the cursor has been guided to the advertisement. The dynamic nature 
of these effects can be achieved either through scripting (e.g. using such languages as 
VBScript or JavaScript) or programming (e.g., using such programming constructs as 
Java applets and ActiveX controls). The ability to incorporate compelling authored 
effects in Web sites is limited only by the developer's creativity. 

Although authored effects can allow much more compelling forces to be provided 
in web pages because they can be carefully correlated with images, animations, and 
sounds. They have the disadvantages of typically requiring specific force effect 
instructions in the web page that are downloaded by the client and sometimes require 
specific force-enabled resources on the client end. 

A different embodiment uses a form of authored effects to specify generic effects. 
For example, if an author does not want to include authored effects in a web page but 
wishes to specify one or more generic force effects for object types on the web page, the 
author can include generic effect designations. For instance, a number of standardized 
generic effects sets (as described above) can be provided on client machines, and each 
web page downloaded can specify in an HTML tag (or otherwise) which generic effect 
set (or a particular generic effect within a set) to use for the downloaded page. Thus, the 
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author has, in effect, authored the force effects by referring in the web page to generic 
effects resident on the client. Or, the tag in the web page code can refer to an official or 
customized generic effect set that the user is presumed to have previously installed on the 
client machine (and, if that customized effect set is not installed on the client, a default 
generic effect set can be used). The author can simply specify that there is a force 
enclosure on an object, but allow client defaults or preferences to assign forces and/or 
force characteristics to the enclosure (e.g. to the walls and/or interior of the enclosure). 

A user can experience both authored effects and generic effects in a particular 
downloaded web page. For example, the user can set generic effects to types of objects 
displayed in the web page, as defined by the user's preferences stored on the client. 
There can also be authored effects in the web page that are specified in information 
downloaded with the web page. Any authored effect that conflicts with a generic effect 
can be set, by default, to override the conflicting generic effect. This allows special 
authored effects to still be felt by the user, yet also allows any other web page objects not 
assigned any authored effects to have the user's preferred generic effects assigned to 
them. As is analogous to the color of hyperlinks, the user on a client machine can also 
preferably specify whether to override any authored forces of a downloaded web page 
with preferred generic effects; or the user can specify to use the authored effects or the 
generic effects specified by the web page author (which may fit the theme of the web 
page better than the user's choice of generic effects, for example). 

In yet another embodiment of the present invention, either authored effects or 
generic effects can be implemented by continuous reception of force feedback data over a 
network, e.g. similar to "streaming" video and audio. For example, parameters to 
specify and characterize forces can be included in streaming video and audio data to 
provide tactile sensations to the user of the client machine receiving the streaming data. 
Tags or references to force effects already resident on the receiving client machine can be 
included in the streaming data. Alternatively, all or most of the data defining the force 
effects and the data required to implement the force effects can be included in the 
streaming data. 



Embodiments for Implementing Force Feedback over Networks 

The following subsections detail several embodiments of software that allow a 
user to feel web pages. These embodiments retrieve web page data, track user interaction 
with the web page, and output the appropriate force effects to the tactile display. 
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Proprietary Browser 



An efficient embodiment to enable feel in web pages is to implement the force 
effect functionality directly in the web browser, such as Netscape Communicator by 
Netscape Communications or Internet Explorer by Microsoft Corp. A web browser 
parses Hypertext Markup Language (HTML) files retrieved over the Internet and visually 
displays the content of the web page. In the present embodiment, a browser may also 
track a user-controlled cursor's interactions with the displayed content and apply force 
effects accordingly. Since the web browser has intimate knowledge of the web content, it 
can perform these tracking operations more easily than many other methods can do so. 
This embodiment is most feasible for entities that have already written a Web browser 
(such as Microsoft and Netscape). In addition, publicly available source code of a web 
browser (e.g., Netscape Communicator) can be modified by a different party to 
incorporate force feedback functionality directly into the browser and re-released to the 
public. 

This embodiment can apply generic effects to web page objects, which is typically 
used for standard web pages. However, HTML tags (commands) can also be created 
which can define authored effects in a downloaded web page and which the web browser 
can interpret and implement, similar to the function of the plug-in software described 
below in the plug-in embodiment. The use of authored effects can alternatively be 
achieved in this embodiment by providing Java applets or ActiveX controls in the web 
page, as described in greater detail below. 

Dynamic HTML 

Dynamic HTML is a set of features currently in browsers such as Microsoft 
Internet Explorer 4.0 that enable authors to dynamically change the rendering and content 
of an HTML document. Using Dynamic HTML, a content developer or programmer can 
access the attributes of the graphical objects of an HTML document (such as the object's 
position on the web page and the object's HTML tag or type). In addition, event 
messages are generated when a user selects or interacts with the Web objects (such as 
when a user clicks a button while the mouse pointer is over the object). The power of 
Dynamic HTML can be elicited, for example, through the use of VBScript or JavaScript 
scripts embedded in a web page or programmatically, e.g. in a web browser, through 
Visual Basic or C++, as is well known to those skilled in the art. 

Dynamic HTML can be used to enable the feeling of generic effects in web pages. 
FIGURE 7 presents a flow diagram of the present invention in accordance with a first 
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Dynamic HTML embodiment in which a separate application program runs in parallel 
with a web browser on a client machine. A user starts a separate application program on 
a client machine in step 284. In a step 286, the application launches a web browser on the 
client machine, and creates/maintains a connection to the web browser. In step 290, this 
application then "hides" in the background of the operating system. After a web page in 
HTML has been received and displayed by the web browser, the application checks for an 
event notification in step 292. The application receives an event notification from the 
browser whenever a user moves the mouse (and/or when another predefined event 
occurs). When the application receives this notification, it can ascertain in step 294 
whether the mouse pointer is touching any relevant object (e.g., a web page object having 
forces associated with it) on the web page through the use of Dynamic HTML functions. 
If no event notification is received in step 292, the process continues to check for a 
notification until the user quits the web browser or the separate application in step 300, at 
which point the connection to the web browser is destroyed in step 302. 

One example of determining if a relevant object is being touched is provided in 
the pseudocode below. Dynamic HTML is hierarchical in nature, where characteristics of 
an object may be provided in parent objects to the object. Since Dynamic HTML is 
hierarchical, the element passed immediately to a requesting application or function may 
not be of interest, but something in that element's hierarchy may be of interest. For 
example, only bold text can be associated with a force effect. The application thus must 
check whether the current object that is "touched" by the pointer is bold text. The below 
function checks this hierarchy. Given a Dynamic HTML object, called "elem", this 
function will determine whether the object is something to which a force-effect is to be 
applied (i.e., it is "relevant"). If a text object is passed to this function, this function will 
search the hierarchy of the text object looking for a "B" tagname that indicates the text is 
bold. It will return null if the object is not relevant, otherwise it will return the relevant 
tagname. 

// This is pseudo-code for the TouchingRelevantObject function. 
TAG TouchingRelevantObject ( HTMLElement elem ) 

{ 

// Is this element valid? 

// This will happen if we've reached the end of the recursion. 

if ( elem IS null ) 

return false; 

if ( elem.tagName ISJN A_SET_OF_TOUCHABLE_TAGS ) 
return elem. tagName ; 

else 

return TouchingRelevantOb j ect ( elem . parentElement }; 

} 

If the mouse pointer happens to be touching a relevant object, i.e. an object 
associated with one or more force effects (such as a hyperlink), the application calculates 
the screen coordinates of the object in step 296 using the dynamic HTML functions. The 
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application then generates the appropriate force effect in step 298, such as an enclosure, 
on the user manipulatable object of the interface device. The force effect can be 
generated by using high level commands sent to the microprocessor of the interface 
device 50, or can be generated by direct low level commands from the host application. 

One difficulty of this approach lies in the determination of screen coordinates of 
the relevant object. The difference between the coordinate frame of the mouse and the 
coordinate frame of the Dynamic HTML object requires that one of the coordinate frames 
be transformed to be operable with the other. The mouse pointer position and effects 
such as enclosures are described in screen coordinates. Dynamic HTML objects such as 
hyperlinks are described in coordinates relative to other Web page objects; to derive the 
absolute screen coordinates of a Dynamic HTML object, several coordinate frame 
transformations may have to be applied based on the returned Dynamic HTML object. 
An example of the hierarchy of objects and the transformations required to achieve screen 
frame coordinates are illustrated in FIGURE 8, which shows coordinate frames in 
Dynamic HTML. The frames may include a screen frame (absolute frame) 310, a 
window frame 312, a web browser client area frame 314 (which is also HTML frame #1), 
an HTML frame #2 316, and a hyperlink frame 318. A particular frame is specified by its 
leftmost and topmost coordinates, relative to the coordinate frame containing the 
particular frame. The hierarchy leading from the hyperlink frame to the screen frame is 
the reverse order of the frames as listed above, starting with the hyperlink frame and 
traversing to the screen frame. 

As currently implemented, it is not possible to compute the absolute screen 
coordinates of a Dynamic HTML object by traversing its transformation hierarchy 
because the farthest traversal is to the client window frame; there are no mechanisms 
available for transforming this client window frame to the screen frame. Also, traversing 
this hierarchy can be computationally expensive, relative to the degree of responsiveness 
that is required in a force-feedback system. If a user moves over a hyperlink object, the 
enclosure should snap immediately; any delays severely degrade the user experience. 

The preferred way to resolve this problem is simple, elegant, and fast. Dynamic 
HTML returns an "event object" when the application is notified of a mouse interaction; 
this event object allows the program to query the mouse position in both relative and 
screen coordinates. These values can be used to ascertain a Dynamic HTML object's 
transformation between relative and screen coordinates. For example, the relevant 
"event" object fields that return the desired values are shown below: 

offsetX — event X coordinate relative to the srcElement's container's frame 
offsetY — event Y coordinate relative to the srcElement's container's frame 
screenX — event X coordinate relative to physical screen size 
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screenY — event Y coordinate relative to physical screen size 
srcElement - the object that cause the event 

The relevant DHTML object fields are provided below: 

offsetLeft - X coordinate of object's left edge, relative to its container's frame 
offsetTop - Y coordinate of object's top edge, relative to its container's frame 

These values indicate the coordinates of the web page object (also known as an 
"element" of the web page) with reference to the object's "container", which is the 
frame that encloses the object (such as the web browser). Once these values are obtained, 
the absolute screen coordinates of the object can be determined as follows: 

objectScreenX = event.screen.X - (event.offsetX - event.scrElement.offsetLeft) 
objectScreenY = event.screen.Y - (event offset Y - event.scrElement.offsetTop) 

These values are illustrated in FIGURE 9. 

Since generic force effects are often used with normal HTML code having no 
force effects included therein, the Dynamic HTML is preferably only implemented by the 
browser or other program providing the generic effects. For example, after the HTML 
document is received, it is processed into Dynamic HTML by the browser or separate 
application on the client so that web object properties can be obtained and generic forces 
applied. Alternatively, the web page can be provided as Dynamic HTML instructions 
and downloaded in that form. 

A second implementation of integrating generic force effects with Dynamic 
HTML can be used in which the web browser itself has the ability to check user 
interactions and apply force effects. As shown in a method 320 of FIGURE 10, the user 
again starts an application program on the client machine in step 322. In step 324, this 
application opens a browser window in the foreground that hosts navigation buttons and a 
browser "engine", e.g., an MSHTML object. MSHTML is the rendering engine used by 
Microsoft's Internet Explorer and is also available for all application developers to use. 
The MSHTML object performs the parsing and rendering of HTML content. To allow 
users to feel the displayed objects of a web page, the application program then applies the 
melhodology described above in Figure 7 with the MSHTML object to directly determine 
(by calculating screen coordinates) when the mouse pointer is positioned in relation to a 
relevant web object (in step 326) such that screen coordinates are calculated in step 328 
and forces are to be output to cause the force feedback interface device to output the 
appropriate forces in step 330. The process quits via step 332 when the pointer no longer 
touches a relevant object. 

The two implementations described above are summarized cliagrammatically in 
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FIGURES 11a and 1 lb. In a first implementation of Fig. I la, a proprietary application 
includes a connection to Internet Explorer, Netscape Navigator, or other available, 
standard web browser application. The browser 340 displays web page content 342. The 
proprietary application 344 also runs simultaneously (e.g. multitasks) which is used to 
control forces for the web page content. The browser 340 provides event notifications to 
the application 344 indicating, for example, when the mouse pointer touches a relevant 
object. Upon event notification, the application 344 verifies if the element is touchable; 
if so, the application queries the browser 340 for element information such as the element 
frame in screen coordinates. The proprietary application 344 determines and outputs 
commands for generic force effects to the API (such as Feelit API) for the mouse or other 
manipulandum, which are output as force sensations correlated with the web page content 
displayed by the web browser 340. 

In a second implementation of Fig. lib, a proprietary application 348 hosts 
MSHTML as described above, and does not connect to a standard, available web 
browser. This implementation uses the same notification/query mechanism used in the 
first implementation. 

The advantage of the first implementation is that a standard, well known web 
browser is used as the interface to the web page, which is familiar to users. Also, users 
can easily take advantage of web browser upgrades and improvements as provided by the 
browser company. Unfortunately, the connection between web browser and the feel- 
enabling application program can be tenuous. The connection can be prone to many bugs 
and may be slow, and may not have the responsiveness required by a force-feedback 
application. On the other hand, in the second implementation, there is an extremely tight 
coupling between the browser engine (e.g. MSHTML object) and the feel-enabling 
application because they are in the same process space. Thus, event notification in this 
implementation is robust and fast. The drawback is that users must use an interface that 
is not as full-featured as a proprietary web browser nor as familiar. They are identical in 
terms of the display of web content, but a proprietary web browser typically has many 
more features and functionality for manipulating, editing, navigating among web pages, 
such as "Favorites" and "History" options to provide easier browsing. 

The Dynamic HTML embodiment, when used without other tools, can only apply 
generic effects. In order to incorporate authored effects, it must be used in combination 
with either Java applets or ActiveX controls, both described below. 

One example of providing generic effects to a web page using dynamic HTML is 
provided as source code in APPENDIX A. This source code provides, for example, snap 
enclosures on links. 
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Active Accessibility 

Active Accessibility is a suite of programming libraries and computer programs 
created by Microsoft Corporation to make the Windows operating system more 
accessible to the disabled. One feature of Active Accessibility is that it can invoke third- 
party functions, known as hooks, when a user interacts in predefined ways with the 
graphical user interface (GUI). For example, an application developer can create a 
function that is called when the user moves the mouse or opens any window. 

Using Active Accessibility to enable generic force effects for Web page objects 
involves the creation of a program that provides Active Accessibility hooks, including 
conditions which are to be checked and which functions to call when a condition is met. 
For example, the program runs on the client machine external to a web browser and is 
hooked into mouse moves. When the mouse move hook is invoked, the program 
instructs Active Accessibility to call one or more functions which request information 
from Active Accessibility to determine characteristics of the web page object that the 
mouse pointer is positioned over (if any), such as position coordinates, the type of object 
at those coordinates, the name of the object, other characteristics or properties, if the 
object is a link, etc. If the object is associated with one or more force effects, the 
appropriate calculations and force effects are applied. The limitation of this embodiment 
is that the web browser must support Active Accessibility. Currently only one Web 
browser does so: Microsoft Internet Explorer. 

This embodiment can be combined with a GUI force feedback control application 
(such as the FEELit Desktop from Immersion Corporation) and used to enable generic 
effects in all browsers that support Active Accessibility. As with the proprietary browser 
and Dynamic HTML embodiments, this embodiment can be combined with the Java 
applet or ActiveX embodiments to enable authored effects. 



Java Applet 

Java is a popular programming language for web page development. An applet is 
a program written in Java that can execute in a web page while the web browser is the 
active application of the operating system on the client, as is well known to those skilled 
in the art. A web page developer can create applets that make use of force feedback 
functionality, e.g. using the FEELit API from Immersion Corporation. These applets can 
be similar to any program that can normally be created with such force feedback 
functionality, but can execute "inside" a web page. An applet typically has a defined 
area on the web page in which it executes to display visual information or perform other 
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tasks. For example, a developer working on a physics education web page can create an 
applet that allows a user to feel the force field between two virtual magnets displayed on 
a web page; the user can interactively move the magnets using the mouse 36 and feel how 
the force Field changes. The feel interactions may be limited to the active area in which 
the applet executes. However, the fact that Java applets are actually dynamic programs, 
rather than static content, allows an endless range of possibilities for touch interaction 
with web pages. 

There is one barrier to implementing this embodiment, but it is easily overcome. 
The Java language was created to be platform independent and provide strong security. A 
force feedback instruction set such as the FEELit API from Immersion Corp. may violate 
security restrictions inherent in Java. However, Java has mechanisms for incorporating 
native (platform-specific) methods into Java applets. These mechanisms can be used to 
create a Java-compatible version of the FEELit API, allowing Java programmers to easily 
add force effects to their applets. 

This embodiment can support authored effects and may be used in conjunction 
with the embodiments described above that support generic effects, if desired. 



ActiveX Control 

The final embodiment of incorporating feel into web pages described herein is the 
use of ActiveX controls implemented within the ActiveX language by Microsoft 
Corporation. ActiveX controls are programmable objects that can be "embedded" into 
(i.e. referenced and used by) web pages, as is well known to those skilled in the art. 
These objects can be written in any language. The primary purpose of ActiveX controls 
is to add functionality to a web page that would normally be difficult, or even impossible, 
using HTML and scripting languages. For example, a "graphing" ActiveX control can 
take spreadsheet data, display a graph of it on a web page, and let the user manipulate it 
in real-time, e.g. by selecting a point on the graph and moving it, displaying a portion of 
the graph in greater detail, etc. Another feature of ActiveX controls is that they can be 
scripted. This means that a content developer can embed an ActiveX control in a Web 
page and control it with a scripting language. For example, a JavaScript text box can be 
scripted to change the title of the graphing control's title bar. Another way to perform 
this feat is to create a Java applet; however, the advantage of ActiveX controls is that they 
can be coded in any language. This advantage is also potentially a drawback because a 
particular ActiveX control will only work on one platform, whereas a particular Java 
applet will work on any platform. 
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There are two fundamental ways in which to use ActiveX controls to add feel to 
web pages. The first way is to create an ActiveX control that contains dynamic visual 
and force content. Thus, each ActiveX control embedded in a web page would have its 
own predefined force effects, and only be able to perform those effects. This approach is 
similar to that of the Java applet, except that the implementation language is different. In 
particular, as currently implemented, the force content of an ActiveX control is limited to 
the active area of the ActiveX control, just like a Java applet. This approach is faster than 
the second " force-only" approach since no scripting in HTML is required. 

A second, more versatile, and preferred approach is to create a "force-only" 
ActiveX control that is solely responsible for generating different force effects 
(alternatively, a small number of ActiveX controls can be provided to control forces). 
This ActiveX control is embedded in (referenced by) the web page file and can be 
commanded with scripting instructions to create, modify, and trigger force effects. This 
scripting functionality allows content developers to easily tap the capabilities of the 
ActiveX control without needing to do any custom programming. For example, the 
force-only ActiveX control can be called by JavaScript or HTML instructions in the web 
page with a command to perform a particular force effect. The ActiveX control would 
then control the force feedback device to output the commanded force effect(s). For 
example, one way to call the ActiveX control "FeelControl" with a script in the HTML 
code of the web page is as follows: 

// This HTML code line demonstrates how to make an image vibrate when clicking on it. 
// This force-only ActiveX control has an ID of FeelControl and can implement the 
// force effect: 

// Vibration ( long period, long duration ) 

// period in milliseconds 

// duration in milliseconds 

// 

<IMG src= M myPicture .gif " onmousedown=" FeelControl . Vibration { 100, 1000 ) "> 

A central authority, company, organization, etc. can develop and refine the force-only 
ActiveX control and allow web page authors to incorporate the force-only control into 
their web pages. For example, a web page author can embed a reference to the central 
web site to download the force-only ActiveX control. The ActiveX control can be 
downloaded to the client with the web page if the control is not already resident on the 
client i.e., once the control has been downloaded to a client, it does not need to be 
downloaded again until the control has been updated to a new version or otherwise 
changed by the central authority. This is because the control is resident on client storage 
such as a memory cache or hard disk after it has been downloaded the first time and can 
be accessed locally by other web pages that embed it instead of downloading it. With 
such a control, a web page author can access the full functionality of a force feedback 
command set such as the FEELit API from Immersion Corporation using only the 
ActiveX control and a scripting language. Coupling this with Dynamic HTML yields a 
Docket No. IMMIP062 

-33- 



# 



powerful tool for authoring feel into web pages. 

To illustrate the usefulness of the second approach, several example web pages 
are illustrated in FIGURES 12-15. The web page shown in Figure 12 includes several 
images that represent tactile experiences, where the user is able to feel a force associated 
5 with the image by moving the pointer over the image and/or maintaining the pointer on 
the image. For example, a user can move and maintain the mouse pointer over image 362 
to feel the force of an engine starting up and revving. Image 364 provides a texture feel 
as if fingers were moved over tennis racket strings. Image 366 provides a sequential jolt 
and vibration similar to the sound effect of a laser. Image 368 provides an elliptical 
10 contour force obstruction to allow the user to feel the edge of the depicted crater. Image 
370 provides a "slippery ice" sensation, where the mouse is assisted with forces to make 
it difficult to maintain the pointer on the image. Finally, image 372 provides a texture 
similar to feeling a corduroy cloth when the mouse pointer is moved over it. The 
ActiveX control commands a texture force to be output on the mouse so that the user can 
15 feel it. An example of source code to implement these forces with a force-only ActiveX 
control is provided in APPENDIX B. This example uses hard-coded force effects; in 
|4 other embodiments, force effects stored in separate files can be used with the ActiveX 

Ill control. 

l 

g The web page 380 shown in Figure 13a and web page 387 in Figure 13b are 

W 20 interactive, dynamic multimedia demonstrations with feel. In web page 380, a user may 

j J3 compress any of springs 382a, 382b, and 382c using the mouse pointer by pushing the 

13 mouse pointer down on the end lines 386 of the springs. A spring force is output on the 

Ml 

mouse to resist the compression motion. In web page 387, the user may similarly push 
the mouse pointer against end lines 388 to compress the ball 384. If the user compresses 
25 the ball 384 too much, it "pops" both visually and haptically, i.e. a picture of a 
punctured, flattened ball is displayed and the user feels a jolt of the ball popping. The 
user can then return the ball to its original state by pressing button 389. 

The web page 390 shown in Figure 14 allows a user to move a basketball 392 
around a field or "court" by "pushing" the ball with the pointer 394. The mouse pointer 
30 is prevented from moving inside the ball 392 and a barrier force is output on the physical 
mouse when the pointer moves against any side of the ball, so that the user can feel the 
outline of the ball. In addition, the mouse movement against the ball causes the ball to 
move in the same direction as the pointer, as if pushed by the pointer. The mouse will 
feel the force of motion of the ball if the pointer is moved in front of the moving ball. 

35 Finally, the web page if Figure 15 illustrates a dynamic force simulation including 

a moveable block or "cart" 396 with an upside-down pendulum 398 extending from it on 
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a pivotable rod 399. The pendulum is biased by gravity to pivot around its connection 
point to the cart. By moving the cart under the moving pendulum by pushing the cart left 
and right with the mouse, a user can try to keep the pendulum from falling underneath the 
cart. As the pendulum and cart moves, appropriate forces are output on the mouse 36 
depending on the motion/position of the pendulum and cart and accounting for a 
simulated weight of pendulum and cart. This can serve as either a game, a physics 
lesson, or both. These demonstrations only begin to hint at what is possible using web 
scripting languages and ActiveX controls. An example of source code used to implement 
the dynamic force examples of Figures 13a, 13b, 14, and 15 is provided in APPENDIX 
C. 

Both Java applets and ActiveX controls of this embodiment only support authored 
effects. However, it is possible to emulate generic effects using the second approach. 
Mechanisms for doing this are described in the next section. 



Implementing Generic Effects Using ActiveX Controls 

The embodiments described above that support generic effects are the Proprietary 
Browser, Active Accessibility, and Dynamic HTML embodiments. If none of these 
embodiments are available, another option may be used. Using mechanisms available in 
a force-only ActiveX control (described above), generic effects can be added to existing 
web pages as authored effects, with no need for the author of the web page to add the 
force effects manually. 

The first method of achieving this is to pre-process an incoming HTML file. 
Whenever the web browser receives an HTML file, a separate program can process it 
before it is parsed and displayed. This processing step would modify the HTML file, 
embedding the force-only ActiveX control, adding JavaScript code to facilitate force- 
effect scripting, and utilizing Dynamic HTML to assign effects to web page objects such 
as hyperlink objects. The types of effects added to the web page can be determined from 
a user-configurable preferences set or control panel, just as normal generic effects would 
be. For example, the user previously designated which types of force effects would be 
associated with which types of web page objects, and these preferences are read from a 
stored file or other computer-readable medium (or default mappings are used). The end 
result would be the experience of generic effects although they are actually and 
transparently inserted into the web page as authored effects by an external program. 

The major drawback to this approach is that it is not seamless. In particular, it is 
difficult to assign a program to process an incoming HTML file. Few browsers, if any, 
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support this functionality. In addition, it may be time consuming for a user/client to have 
to download an HTML file, pass it to a pre-processing program, and then load it into a 
web browser. 

A different embodiment utilizing a proxy server ean eliminate some of the 
difficulties of the above-described embodiment. A proxy server is a server computer that 
receives Hypertext Transport Protocol (HTTP, the underlying communication protocol of 
the World-Wide Web) requests from a client computer and performs that request on its 
behalf. Proxy servers are often used to allow Web access beyond a firewall; the proxy 
server has special privilege to access the Internet beyond the firewall, so all HTTP 
requests must go through it. Proxy support is common feature in web browsers and is 
extremely easy for a user to configure. 

FIGURE 16 is a block diagram illustrates the use of a proxy server for force 
feedback functionality over the Web, in which generic effects are emulated with authored 
effects. To solve the pre-processing problem, an interested party, company, organization, 
etc. can set up a proxy server 400 connected to the Internet 402. This proxy server 400 
accepts all HTTP requests from client computers, such as requests to receive particular 
web pages. For example, a host computer 404 is to receive a web page from a desired 
web server 406. The host 404 issues a request 408 to the proxy server 400. The proxy 
server 400 then issues a request 410 on the host's behalf, which is received by the 
requested source 406, such as a web server computer over the Web. The web server 406 
then fetches the desired dofcument/web page and sends the document 412 to the proxy 
server 400. 

After receiving the requested document 412, a normal proxy server would then 
pass the requested web page back to the client; however, the proxy server 400 of the 
present invention first applies the pre-processing (described above) to the web page 
document to modify the web page file (embedding a force-only ActiveX control, adding 
JavaScript code to facilitate force-effect scripting, and assigning effects to web page 
objects such as hyperlinks), if the document is an HTML file. The proxy server may 
receive and read user preferences from the client to determine which force effects to 
assign to which web page objects. If the document is not an HTML file, no pre- 
processing is performed. The proxy server 400 then transmits back the new generic- 
effect-enabled web page 414 (or other type of document if no preprocessing was 
performed) to the client computer 404. Thus, the client's user is able to feel the web page 
in a seamless manner, and without having the client expend time in preprocessing 
operations. 
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Plu g-In Embodiment 



Another embodiment for implementing force effects is to provide a "plug-in" 
extension to the web browser at the client machine, such as Netscape Navigator. The 
plug-in, for example, can implement authored force effects, where the plug-in handles 
particular force-related commands or information in a received HTML file. A plug-in 
may also or alternatively implement generic force effects for a web page by referring to 
the generic effects on the client machine when an appropriate event takes place, such as a 
pointer moving over a hyperlink. The plug-in software can be a proprietary extension of 
the web browser software developed, for example, by Immersion Corporation. A plug-in 
is similar in function to the ActiveX control described above. 

In one embodiment, instructions are provided in the received web page which 
define an authored force effect for the plug-in. For example, an <EMBED ...> tag can 
define a force button object that will be displayed on the client machine. Other force 
objects besides button objects can also be defined and displayed, such as links, text, 
sliders, game objects (balls, paddles, etc.), avatars, windows, icons, menu bars, drop- 
down menus, or other objects. In a first line of the <EMBED ...> command, the force 
button object can be defined by a "IFF" extension file, namely " FORCEBUTTON.IFF." 
The <EMBED ...> command is an existing functionality of HTML. It essentially embeds 
function calls which are handled by the web browser. If the suffix of the specified file is 
a known, standard suffix type, the call is executed directly by the web browser. If, 
however, the suffix (.IFF in this instance) is not a standard feature of the web browser, 
the browser will first look for a "plug-in" to implement this feature and, if a suitable 
plug-in is not found, it will look for application programs implementing this feature. In 
the preferred embodiment of the present invention, a plug-in including a reference to a 
Dynamically Linked Library (DLL) is provided to give functionality to the .IFF suffix. 
The DLL can be provided local to the client machine or on another linked resource. 

In the <EMBED...> specification, the size of the button can be specified, the 
initial state of the button ("up" or "down"), and the force effect associated with the 
button, such as "vibration." Parameters defining the character and nature of the force 
effect can also be specified (start time, length, frequency, magnitude, etc.). A "trigger" 
for the force effect can be specified, such as a function "MOUSEWITHIN" with its 
associated parameters, and by a function "BUTTONS TATE." The function 
MOUS EWITHIN determines whether the pointer icon, the position of which is controlled 
by the force feedback device, is within the specified boundaries defining a region of the 
force button. This region can be specified by the parameters. The function 
BUTTONSTATE determines whether a button or switch of the force feedback device is 
in the desired state to trigger the force object event (e.g., a button event in this example). 
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The image file and text representing the force button can also be specified. Other force 
effects, triggers and parameters can also be associated with the force object. For 
example, a force (such as a vibration) can be triggered if the pointing icon is moved a 
predetermined velocity or within a predefined range of velocities within the force object. 
Or, a trajectory of the pointing icon on a force object can trigger a force, like a circle 
gesture. 

The plug-in embodiment also provides for programmability of the embedded 
force feedback object. An optional programmable command can be inserted into the 
EMBED command and can include, for example, an iterative loop to cause a force effect 
to be repeated a specified number of times and/or to cause a wait for a specified time after 
a force effect has occurred. By providing programmability to the force feedback object, 
force feedback effects based upon past events and upon a complex interaction of factors 
can be provided. 

If there is an embedded "tag" for a force effect in the HTML file, e.g. a tag or file 
having an .IFF reference, then the plug-in software is used to interpret the .IFF file. In 
one embodiment, a "framework" is created for the force effect (or "force object" ). The 
framework provides a particular set of generic features to implement the specified force 
object, and preferably includes no specific parameters or functions for the force object. A 
name and associated parameters from the HTML file are then parsed and the force object 
is built upon this framework based upon the parameters. For example, one name might 
be " BUTTONSTATE" and its parameter might be " UP" (or " UNSELECTED" ). 

The plug-in software can monitor the position and button state of the force 
feedback device. The plug-in creates a force feedback command in response to the 
detected position and state (if appropriate), and a command is sent to the Dynamically 
Linked Library (DLL) to place a force feedback command on the interface which can be 
parsed and interpreted by the force feedback device. 

It should be noted that the force feedback driver (browser plug-in or DLL) can 
have the ability to interact with Java code. In this embodiment, the plug-in reads and 
executes Java commands using the browser's run-time Java interpreter. It should also be 
noted that the force feedback device itself can have a Java interpreting chip on board, 
permitting the plug-in driver to download Java code to the force feedback device to be 
executed on the device. Java and Java interpreting chips are available under license from 
SUN Microcomputers of Mountain View, California. 

The embodiments disclosed herein can have the ability to interact with 
instructions provided in other languages besides HTML. For example, virtual reality 3-D 
graphical environments are increasingly being created and implemented over the World 
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Wide Web and Internet using languages such as the Virtual Reality Modeling Language 
(VRML). In these 3-D graphical environments, users may interact with programmed 3-D 
objects and constructs using client computer 14 or 16, and may also interact with 3-D 
graphical representations (or "avatars") controlled by other users over the World Wide 
Web/Internet from other client computers. Force feedback commands and parameters 
can be provided in the instructions or files of these other protocols and languages and 
received by a client computer system in an equivalent manner to that described above so 
that force feedback can be experienced in simulated 3-D space. For example, embedded 
force feedback routines for authored force effects can be included in the VRML data for a 
virtual environment so that when the user moves into a virtual wall, an obstruction force 
is generated on the user-manipulatable object. Or, when the user carries a virtual object 
in a controlled virtual glove, the user might feel a simulated weight of the virtual object 
on the user manipulatable object. In such an embodiment, the force feedback device 
preferably provides the user with three or more degrees of freedom of movement so that 
input in three dimensions can be provided to the client computer. Alternatively, generic 
effects can be provided with VRML files having standard object types (walls, ramps, 
stairs, ice, avatars, gloves, chairs, guns, etc.) 

Authoring Tool for Adding Force Functionality to Web Pages 

Associated with the methods of providing web pages having force effects as 
described herein are methods for allowing authors to easily create web pages with force 
effects. A web page author does hot have an intuitive sense as to how forces will feel 
when assigned to particular objects or adjusted in certain ways, and thus must go to great 
effort to develop characteristics of forces that are desired for a specific object of 
interaction. For example, a programmer may wish to create a specific spring and 
damping force sensation between two graphical objects on a web page, where the force 
sensation has a particular stiffness, play, offset, etc. Current web page authoring tools do 
not allow the design of force effects associated with web page objects. Furthermore, 
current force effect design tools are not oriented to the particularities of web page 
authoring, such that a web page designer is without a professional development tool to 
assist in authoring force effects. 

The web authoring application interface described herein is one example of a 
force-enabled tool for authoring web pages. For example, the interface herein ("FEELit 
Studio") is described in connection with the I-Force Studio® available from Immersion 
Corporation, which is a force-effect authoring interface intended for use with application 
programs such as game programs. This interface can be used with mouse 36 (e.g., the 
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FEELit Mouse developed by Immersion Corporation). The application allows users 
inexperienced with HTML syntax and unfamiliar with force feedback to quickly create 
HTML pages with feel content, along with standard content such as graphics, text, and 
sound. The application uses common user interface features found in most web authoring 
5 applications today. These features should allow the user to easily insert and place content 
and immediately feel, see, and hear the results. Once the web page is saved as a file by 
the authoring interface, the user can send the created web page to a web server to be 
accessible to end users over the Internet or other network; or, the saved web page might 
be already available over the Internet if it is resident on a machine (such as a client 
1 0 machine) having appropriate accessibility over the Internet (or other network). 

Adding force effects to web pages can be very simple. However, to add effective 
force effects, the feel sensations should appropriately match the rest of the web page 
content. This requires a creative and interactive process where parameters are defined, 
p experienced, and modified until the feel sensations are fine tuned. A clumsy and non- 

s -jj 1 5 intuitive design process means the web author will spend much less time being creative. 

M • 
Ill 

14 The web page authoring tool of the present invention is used for authoring web 

1^ pages that include force effects. In one embodiment, the web authoring tool is an HTML 

112 

editor, such as an editor that is provided with a web browser, with additional force 

0 functionality. 

w 

\% 20 FIGURE 17a is a screenshot of an HTML editor 429 that has been modified 

m 

1:9 according to the present invention to include the ability to design and add forces to web 

1 ^ pages according to the present invention. The HTML editor is a WYSIWYG (What You 

See Is What You Get) editor for creating a web page, meaning the author sees exactly 
how the web page will look to others as the author edits the page. The author may type 

25 text directly into the editor as it will appear, and can place images and other web objects 
using GUI tools. The author may assign text, an image, or other object as a hyperlink 
using menu controls. The HTML editor then outputs the finalized web page as an HTML 
file that includes all the required HTML instructions necessary to implement the created 
web page layout. This GUI method of creating a web page is in contrast to creating a 

30 web page directly using HTML code. When using the editor, the obtuse syntax of the 
HTML document is hidden from the author as well as the end user. 

For example, the logo and image on the web page shown in Figure 17 is provided 
with HTML code speci fying the position of the logo and image and references the image 
file used to display the image. The WYSIWYG FITML editor provides a more intuitive 
35 method of creating the logo and picture. The user simply places the cursor where he or 
she desires the picture to appear on the web page and then selects the "Insert Image" 
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command from either the " Insert" pull-down menu or the right-click context menu. A 
dialog box is displayed and allows the author to specify an image file. A similar process 
is used to make the image a hyperlink to another web page. An HTML editor which 
visually shows what the page will look like rather than display the underlying source text 
5 used to construct the page is much easier to use and understand. The same can be said for 
adding feel sensations. 

The HTML editor of the present invention not only is a WYSIWYG editor for 
visual design of web pages; it is also a WYSIWYF (What You See Is What You Feel) 
editor, meaning the author immediately sees and feels exactly how the web page will feel 
10 to others as the author edits the page. Just as the obtuse syntax of the HTML document is 
hidden from the author, the mechanism enabling feel content in the web page should be 
abstracted from the author. This mechanism can be ActiveX and JavaScript components 
or some other technology such as the methods described above. The author is presented 
with a set of controls and tools that allows quick and simple addition of compelling feel 
j 3 15 content without having to understand the underlying technology. Authors may easily 
lij assign feel properties to all web content, including graphics and text. Designed force 

I* effects can be saved as a resource and can be reloaded and modified. End-users can also 

in 

customize the sensations they feel on web pages authored with the authoring tool. 



is* 



For example, as shown in Fig. 17a, a "Properties" dialog box 432 can be 
20 displayed in the HTML editor when the image 430 of the mouse on the web page is 
||( selected and the properties menu from a drop-down menu is selected. This dialog box 

13 432 is used to add to or change properties of the selected object. Thus, an image file can 

be associated with the selected object (in this case, " mouse.gif ') using the "image" tab 
434, the object can be designated a link object and the linked location is specified in the 
25 input field using the " link" tab 436, or the placing of the image or associated text can be 
changed using the "paragraph" tab 438. 

A fourth tab 440 of the present invention is named "Feel" and is provided in 
addition to the "Image," "Link," and "Paragraph" tabs. The Feel tab can be selected to 
bring up a new screen, page, or dialog box presenting a number of options for the author 
30 to select in designing forces to add to the image 430. This feel property page would 
allow the user to customize the feel of the image using one or more force effects. A list 
of force effects can be presented from which the user can select one or more. Also, in 
some embodiments a full design interface as shown in Figs. 19a- 19c can be presented to 
allow a user to design forces as well as assign them to web page objects. 

35 FIGURE 17b illustrates another example of providing options for the user to 

assign a force effect for a web page object. In web page authoring tool 444, the user has 
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selected the web page object 445, an image, and has commanded the force and sound 
assignment window 447 to open, e.g. with a click of a right mouse button or the selection 
of a menu item. Assignment window 447 allows the user to assign one or more force 
effects from a list 448. In the example shown, the user has selected "BumpyRoad" force 
effect 451. 

The user may also select via the control menu 452 the conditions or " events" 
required for one or more selected force effects to be "played", i.e., output using the force 
feedback device 50. For example, the control menu 452 allows the user to select whether 
the force effect will be output when the mouse cursor is over the associated web page 
object, or when the user clicks a button of the mouse while the cursor is over the object, 
or when then the user double-clicks a button of the mouse while the cursor is over the 
object. Other events related to the web page object can also be assigned and/or defined 
by the user. A toggle button 443 allows the user to select whether a force continues to 
"play" after the cursor moves out of the boundaries of the web page object. For 
example, some time-based force effects have a particular duration after being started that 
can continue after the cursor leaves the object. 

The user can also select a different "resource" file using button 453 to provide a 
different list 448 of force effects; each resource file, for example, can include different 
force effects. A resource file or force effect in list 448 can be stored on a local client 
machine (e.g. for generic effects or downloaded authored effects) or can be stored 
remotely over a local-area network or the Internet and downloaded as necessary. The 
content of a force effect file is typically much more compact in size than the content of 
image or sound files, since a force effect need only be characterized in a force effect file 
using parameters such as magnitude and duration. The parameters are utilized by 
resources already resident on the client machine to output the characterized force. For 
location-based force effects requiring more input than simply selecting a force effect, 
another assignment window can be displayed. For example, if an enclosure force effect is 
desired to be assigned to web object 445, the user could draw the exact shape and size of 
the enclosure in an interface as shown below in Figs. 20-24. Or, the user can designate 
the exact location on the web page displayed in the interface 444 where an attractive force 
is to be centered. 

A test button 442 preferably allows the user to test a selected force effect from the 
list 448. For example, the Bumpyroad force effect 451 would cause the mouse grasped 
by the user to immediately shake after the test button was selected. For location-based 
forces such as an enclosure or attractive force, the user can test the force effect by moving 
the cursor to the selected web page object 445 as will be displayed in the web page, as if 
the web page had been downloaded (in some embodiments, all force effects having a 
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"cursor over object" event can also be tested this way). For example, if an enclosure 
surrounded image -445, the user could test the enclosure forces by moving the cursor into 
and out of the displayed image 445. The bumpy road effect 451 can be tested in some 
embodiments by moving the cursor over the object if the event 452 requires such. 

5 The user can also preferably associate audio feedback with web page objects 

using the web page authoring tool of the present invention, where the audio effects are 
synchronized with any force effects of the web page object. For example, in editor 444, a 
list of sound files 446 is displayed which are available to be associated with the web page 
object 445. These sound files can be stored on a client machine or on a different machine 

10 accessible over a network, and are preferably in a standard format, such as wav or mp3. 
The add button 448 allows the selected sound file to be associated with the selected web 
page object, and the sound will be played when the event in window 452 occurs (any 
assigned force effect 451 will also begins at the designated event). The test button 450 
allows the selected sound file to be played immediately in the authoring tool (assuming 

15 output speakers are connected to the computer displaying the web page authoring 
application). Once a sound file has been associated with a web page object, the output of 
the sound is automatically synchronized with the output of the associated force effect. 
Since many force effects have much less impact or immersiveness on a user without 
sound, this feature allows straightforward association and synchronization of force effects 

20 and audio effects. 

An example of HTML code for a web page including an image such as image 
445, which has been associated with an "engine" force effect and an "engine" sound, 
follows. This code uses JavaScript to call a force-only ActiveX control, as described 
above. The force-enabled authoring tool preferably automatically generates this code 
25 when the user wishes to save the created web page. 

<!DOCTYPE HTML PUBLIC " - / / W3 C/ / DTD W3 HTML/ / EN M > 

<HTML> 

<HEAD> 

30 <META content="text/html ; charset=iso-8859-l " http-equiv=Content -Type> 

<META content =' "MSHTML 4 . 72 . 3 110 . 7 " » name=GENERATOR> 
</HEAD> 

<BODY onload= "openf orceresource ( 1 F : /web/ Sounds . if r 1 ) ; " > 
35 <object ID="_engine" WIDTH="0" HEIGHT= " 0 " 

CLASSID= ,: CLSID : 05589FA1-C356-11CE-BF01-OOAA0055595A" > 
<param name= "ShowControls" value="0"> 
<param name="ShowDi splay" yalue="0"> 
<param. name= "Autostart " value="0"> 
40 <param name= "AutoRewind" value-"l"> 

<param name="FileName u value- " F : \web\sound\engine . wav" > 
</object> 
<P>.</P> 

<OBJECT claSsid=CLSID: 5DFDD466-5B37-11D1-A868-0060083A2742 
45 codeBase=FeelMe . CAB#version=2 , 0 , 0 , 0 height=l id^FeelObj ect width=l> 

<PARAM NAME="_Version" VALUE= " 6 5536 " > 
<PARAM NAME="_ExtentX" VALUE="26"> 
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<PARAM NAME="_ExtentY" VALUE="26"> 
<PARAM NAME="_StOCkProps" VALUE="0"> 
</OBJECT> 

<SCRIPT id="FEELit Base JavaScript" language= JavaScript > 
var loaded = false; 

function openf orceresource (url) 
{ 

FeelObject . OpenForceResource (url ) ; 
loaded = true; 

} 

function doef feet ( force , file) 
{ 

if (loaded) { 

var result = FeelObject . StartEf feet (force, file); 

} 

} 

function noef feet (force, file) 
{ 

if (loaded) { 

var result = FeelObject . StopEf feet ( force , file); 

} 

} 

function f orcecleanup ( ) 

{ 

if (loaded) { 

FeelObj ect . Cleanup ( ) ; 
loaded = false; 

} 

} 

</SCRIPT> 
<P>  </P> 

<P><IMG align^baseline alt-"" border=0 hspace=0 onclick=" " ondblclick=" " 
onmouseout=" " onmouseover= n doef feet (' Engine ') ; ^engine . Stop ( ) ; 
engine . Run ( ) ; " 

src="F: \web\f eelit .gif "></P> 

<P align=right id=FeelMeLogo> 

<A href ="http :/ /www. immerse.com/"> 

<IMG alt="FEEL ME!" height=*31 src= "FeelMeMini '. gif » width«50></A></P> 

</BODY> 

</HTML> 



The web page authoring tool 444 also preferably allows an author to add a 
graphical identifier and/or link to the created web page that indicates that the web page 
includes force feedback functionality. For example, the identifier can be a particular logo 
(e.g., text or a graphical image) that is easily recognized. This identifier can be 
automatically added at a particular predefined/customized location on the web page, such 
as the corner or the bottom center of the page, etc., when the web page is written to a file 
using the authoring tool of the present invention, if the web page includes one or more 
force effects (or the identifier can be included in any web page written by the force- 
enabled authoring application). The identifier can also be of a predefined, customized 
size. When a user of a client machine downloads the force feedback web page, the force 
identifier is thus also displayed so that the user knows whether force-feedback peripherals 
are supported by the web page; if desired, the identifier might also indicate that authored 
force effects are included in the web page. Furthermore, in some embodiments the 
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graphical identifier can be a hyperlink that, when selected with the cursor, will cause a 
force- feedback related website to be downloaded on the client machine. The force 
feedback website can provide force feedback resources such as additional force effects, 
guides, updates, etc. The user can preferably set an option as to whether the identifier 
5 will automatically be included in a web page created by the web editing tool. 

The force-enabled web page authoring tool of the present invention is interactive, 
intuitive, and allows users to instantly feel exactly what they create. For example, after a 
user assigns a force effect to an image in the web page, the user can test the force effect 
by simply moving the cursor over that image while the web page is displayed in the 
10 authoring tool. If the force effect is not quite what the user wanted, a different force 
effect can be immediately assigned. In some embodiments, the user can enter a " test" 
mode of the authoring tool to feel force effects, which is separate from an editing mode. 

FIGURE 1 8 is a block diagram illustrating the web page authoring interface of the 
present invention and an example of a web page structure produced by the interface. The 

15 authoring interface 444 (or 429) creates or edits one or more web pages 454, where 
multiple web pages can be loaded into the interface at one time if desired. Each web page 
454 includes one or more web page objects 455, such as images, text, animations, etc. 
Each web page object can include one or more events 456, which are the conditions 
needed to play or activate an effect assigned to the event, such as a cursor located over 

20 the object or a click of a mouse button. Thus, each event 456 can be assigned to one or 
more effects, such as force effects 457 or sound effects 458 (also, a single force effect or 
sound effect can be assigned to multiple different events). As shown, events can be 
assigned force effects and no sound effects, sound effects and no force effects, or both 
force effects and sound effects. In addition, each web page 454 can preferably be 

25 assigned one or more global events 459. Global events are not associated with a 
particular web page object 455, but are applied universally. Each global event has one or 
more force effects 457 and/or one or more sound effects 458 associated with it, similar to 
the events 456. For example, one global event can occur when the web page is fully 
downloaded by a client, at which point the assigned force effect(s) and sound(s) are 

30 played. A different global event can occur when the web page is exited by the client 
machine. Other global events can be a mouse click or double-click when the cursor is not 
over any web page object (e.g., over the background), when a key on the keyboard is 
pressed, etc. 

FIGURES 19a, 19b, ank 19c illustrate examples of force sensation design 
35 interfaces that can be displayed to e&t the force effects for an object in the HTML editor. 
Alternatively, a separate force design Application, such as I-Force Studio, can be run if the 
user wishes to modify or create a force affect. The shown interface windows are similar 
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to the force sensation design tools provided in I-FORCE Studio® available from 
Immersion Corporation. These design tools provide a fully animated graphical 
environment for ninidly adjusting physical parameters of feel sensations, and then 

. optionally saving thehi as 44 feel resources." Authors may craft tactile feel sensations by 

5/ stretching springs, manipulating surfaces, placing liquids, and adjusting other graphical 
/ representations and physkal metaphors that represent each associated force feedback 

f phenomenon. The design tools also empower end users with the ability to edit the "feel 
resource" using the same intuitive animated graphical controls used by the web page 
author. A user with no programming experience or familiarity with force feedback can 

10 quickly design high-fidelity, compelling sensations using these design tools. Such 
graphical manipulation for design \)f force effects is described in greater detail in 
copending patent applications serial n(W 08/846,011, filed 4/25/97, and 08/877,114, filed 
6/1 7/97, both incorporated herein by reference. 

Fig. 19a shows a number of windows for adjusting parameters for several 

15 different force effects. The author can select a desired force effect from the displayed list 
460 of effects, and may select one or more buttons on the force feedback device 50 from 
list 461 to be associated with the force effect. Window 463 shows a list of force effects 
organized under the "Compound" force effect main heading in list 460, any of which can 
be selected by the web page author (or user). Examples of windows for force effects that 

20 have been selected from list 460 and 463 are also shown. Window 462 shows the 
parameters and graphical representation of an "earthquake" compound force effect. 
Window 464 shows the parameters and graphical representation of an "explosion" 
compound force effect. Window 466 shows the parameters and graphical representation 
of a "slope" force effect (i.e. spring force with a negative coefficient). In all of these 

25 windows, the author may adjust the parameters by entering values into fields or by 
adjusting various portions of the graphical representation, e.g., dragging control points on 
the displayed "earthquake" wave 468 to adjust amplitude and frequency. Parameters like 
frequency, duration, attack and fade levels, and direction are also adjustable by dragging 
graphical controls. The author may adjust the slope effect by balancing the ball 469 on 

30 the slope. In all these cases (assuming the author has a force feedback device 50 
connected to the computer on which the force effects are designed), the author may 
immediately and directly feel the designed force effect on the mouse 50 by pressing an 
appropriate "output" control. 

Fig. 19b shows other force effects that can be designed or adjusted by the user. A 
35 feeling of water, or mud can be easily designed in the damper window 470 by adjusting 
the liquid level and then feeling viscosity forces on the mouse 36 change as the simulated 
liquid 471 flows out of the graphical container. Window 472 shows the design of an 
"angle wall" that provides a barrier force to the user object at a specified angle, and 
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which can be adjusted using a graphical representation of the wall. When adjustments are 
made to the parameters, the author immediately feels the new effect on mouse 36 and can 
judge if the changes enhance the feel or not. Apply and Undo commands allow the user 
to easily keep or discard changes. A user can save, copy, modify, or combine predefined 
5 effects to create a library of favorite feel sensations. The authoring tool also provides 
fully customizable sensations and numerous preset examples: custom sensations can be 
created or predefined effects can be used or modified. 

Fig. 19c shows examples of a design window 474 for designing an enclosure force 
effect and design window 476 for an attract/repel force effect. The various force 
10 characteristics of the walls of the enclosure can be designed, and the interior of the 
enclosure can be assigned a force effect using button 475. The attract/repel force effect 
can be characterized by magnitude, conditions for activation or deactivation, radius/range, 
etc. Any designed forces can be immediately tested by moving the cursor within the 
design window over or near the appropriate graphical representation 477. The forces 
!3? 15 shown in Figs. 19a and 19b are not generally referenced to a screen location; for example, 
ifj the output of a vibration or a damping force does not depend on the location of a pointer 

| T J on a screen. However, the force effects of Fig. 19c and many other web-related and 

HI graphical-user-interface related forces are associated with a particular screen location. 

W For example, an enclosure is a box- or elliptical-shaped object having walls at a particular 

U 20 screen location which provide forces on a manipulandum based on the location of a 

' Ui cursor with respect to the enclosure walls. An attraction force typically attracts the cursor 

1*3 

]% and manipulandum to a particular location on the screen. The user should be able to 

I J immediately test these types of screen-location forces using a cursor in the design 

£-5"| 

%u interface. Thus, in one embodiment, the location with reference to the frame of a 

25 particular force design window should be converted to full screen coordinates so that the 
location of the graphical representation 477 of the force effect is known to the force 
feedback device and forces can be output at the appropriate location when the cursor 
interacts with the graphical representation 477. 

The design interface includes intuitive graphical metaphors so that the user may 
30 adjust force feedback parameters using easy- to -understand controls. It is fully interactive 
and animated, so that the force effect parameters can be adjusted by dragging the pictorial 
control points, adjusting sliders and dials, or typing in numbers directly. The resulting 
sensations are output in real-time to the interface device 50 as the user manipulates the 
parameters. If a user designs a slippery force effect, he/she can immediately run the 
35 cursor over a representation to feel the slipperiness. If the feeling is too strong or too 
subtle, there is a simple control or dialog box to adjust the slipperiness and immediately 
feel the changed effect. The design tool uses real world metaphors like the liquid, slope, 
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and walls in the above interface to ensure users unfamiliar with force feedback will have 
an intuitive understanding of the functions of all the controls. 

In addition, a force design interface such as shown in Figs. 19a- 19c (e.g. I-Force 
Studio from Immersion Corp.) preferably is provided with the ability to allow users to 
test audio feedback that is to be associated with one or more force effects. Preferably, a 
user can designate audio data, such as a "wav" file, mp3 file, or other sound data, to be 
associated with a designed force effect. This can be accomplished by presenting a list of 
audio files and selecting one or more to be associated with a particular audio effect. The 
user can then 44 play" the force effect to test it, and the audio effect will play in 
synchronization with the force effect, i.e. the sound will start when the force effect starts 
(for a force effect having a duration); or the sound is played whenever the force is output 
(for some continuous force effects). Thus a user may iteratively adjust a force to match 
the variances in a sound as the sound is played, allowing the user to adjust the force effect 
and/or the sound for more effective presentation and mutual interaction. 

FIGURES 20-25 illustrate a web authoring feature of the present invention to 
conveniently add force sensations to web pages in a completely customizable, spatially- 
related fashion. Fig. 20 shows a portion of a web browser editor 480 that is displaying a 
web page 482 being edited by a web page author. The web page includes text and an 
image 484. The author wishes to quickly add force sensations to the image in particular 
areas of the image. 

Fig. 21 illustrates the same web page and the use of a drawing tool to add force 
sensations to an image by defining spatial features of the added feel. The author controls 
cursor 486 to draw an outline 488 around the image of the truck portion of the image 484. 
The outline can be drawn using any number of well-known functionality tools of drawing 
or CAD programs (i.e. line drawing tool, freehand tool, an algorithm that automatically 
outlines a desired object in a bitmap, etc.). In addition, the author has drawn outlines 490 
around the wheel portions of the truck image, and has drawn interior lines 492 to 
represent other force sensations. These outlines are intended to define the areas on the 
web page where forces are to be felt by a user with a mouse pointer. The outlines and 
lines are invisible to a user who has downloaded the web page and displayed it normally 
in a web browser, but are discerned haptically by the user with a force feedback device 
50. 

The outlines and lines of image 484 drawn by the author are shown more clearly 
in Fig. 22 without the image. Border 494 represents the extent of the entire image 484. 
Body outline 488 and wheel outlines 490 may be associated with force sensations by the 
author using the web page editor; for example, a particular outline can be selected and 
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one or more force effects can be assigned to the outline or to a particular interaction with 
the outline. For example, outline 488 and outlines 490 can be designated by the author to 
be enclosures having barrier forces on the borders of the enclosures that provide a slight 
wall resistance to the mouse 36. When a user downloads the web page to a client 
machine over the Internet, the user can move his or her mouse pointer to the borders of 
outlines 488 and 490 and feel the outline of the truck and its wheels. In another example, 
the enclosures may be associated with gravity forces when the pointer is moving into the 
enclosure and vibration forces when the pointer is moving out of the enclosure. The 
author can assign a different force effect to each portion or side of an outline, the interior 
of the outline, a portion of an outline, etc. Force effects may be defined that occur 
externally to the outline but are caused by a pointer or button interaction with the outline. 

The lines 492 drawn in the interior of the outline 488 are correlated with borders 
of windows on the truck image and may be associated, for example, with "bumps'* or 
barrier forces (i.e. the mouse 36 is subjected to a bump force when the pointer 486 is 
moved over a line 492). This allows a user who interacts with the web page in a browser 
to feel physical features of the truck while he or she moves the pointer inside the outline 
488. The user can likewise draw an outline within outline 488 to provide an enclosure 
(which is preferably a closed shape). For example, the windshield of the truck can be 
provided with a smooth or ice texture (which causes forces to bias or amplify movement 
of the mouse 36 within the enclosure and cause difficulty in stopping the mouse 
movement as if slipping on ice) while the other interior areas of enclosure 488 are 
provided with a bumpier texture. 

By simply drawing lines or contours in desired places over the image 484, the 
author can add forces at a desired location or region on the web page. This allows careful 
correlation between spatial location of feel sensations and images or portions of images. 
In addition, the author can quickly designate multiple areas inside images, text, or other 
objects which may have different force effects associated with them. This feature allows 
greater complexity of forces to be assigned to web pages to a level of detail greater than 
the level of web page objects. Preferably, an author is also able to draw similar force 
lines or regions on any portion of the web page, e.g. on the background, on text, on link 
objects, on animations/video objects, etc. 

Figs. 23 and 24 illustrate another example of the use of the spatial force editor 
described above. In Fig. 23, web browser editor 500 is displaying a web page 502 which 
includes an image 504 that an author wishes to edit to add force sensations. In Fig. 24, 
the author has used pointer 486 to draw an outline 506 around the jeans portion 508 of 
image 504. The author then assigns the outline 506 a force effect such as a texture. For 
example, a corduroy or rough-cloth type texture can be provided so that a user who view . 
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the web page will feel forces that simulate a cloth-like texture when the mouse 36 is 
moved to move the pointer over the jeans portion 508. However, when the user's pointer 
is moved over the other (non-jeans) portions of image 504 (such as the white background 
areas 510), no texture will be felt. The outlining feature allows a web page author to 
5 designate particular areas within images or other objects to have desired forces. 

In another embodiment, the force feedback web page editor of the present 
invention can include an " auto trace" function which will automatically outline a desired 
sub-region in an image or other object. For example, some existing software such as 
Streamline® from Adobe Systems Incorporated will automatically trace areas or objects 
10 within bitmaps which the user designates to create an outline or boundary so that the user 
y need not manually trace the areas. In the present invention, the author can cause an area 

in a bitmap to be outlined automatically and then assign force effects to the outline. 

|4, It should be noted that users may. modify downloaded web pages in a similar 

;3 fashion as described above to add force sensations to areas on web pages. The outlines 

ill 15 488, 490, and 506 and lines 492 are visible to a user or author when the web page is 

jV displayed by an HTML (or other) editor having the required force functionality, and the 

iH images and forces may be manipulated by anyone using the editor. The outlines and lines 

!0 are preferably invisible when the web page is displayed in normal downloading/browsing 
mode by a web browser (unless, for example, the viewer desires to see the outlines and 

UJ 20 enables a "view force outlines" option in a web browser). 

□ 



1.4 



FIGURE 25 summarizes an embodiment in which a single all-in-one web 
authoring application (the HTML editor shown) contains fully functional force design 
tools which allow the user to design feel sensations directly within the application in 
addition to designing the text and graphics of the page. 

25 A web authoring application 520 includes an HTML editor which can import 

images, add text, animations, or other web objects as allowed by conventional web page 
authoring tools. Application 520 also includes force assigning capabilities according to 
the present invention, so that images, text, or other web page objects can be assigned 
force properties. For example, an image object can be selected and then assigned a force 

30 effect, as shown in Figs. 17a and 17b. In addition, sound files can also be associated with 
the web page objects, as shown in Fig. 17b. 

Furthermore, force design tools are also included in the application 520. The 
forces can be designed in child force design tool "palettes" 522 which are part of the 
parent application 520. The palettes each include a feel editor with graphical controls in a 
35 design window, where each palette is for designing a different type of force effect, like 
the different force effect windows shown in Figures 19a-19c. The user can design 
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textures, vibrations, and other force effects by adjusting graphical and numeric 
parameters; such parameters can include effect type, magnitude, direction, type-specific 
parameters (e.g. frequency, spacing), duration, triggers by button-press or mouse-over, 
and the active region of an object (the default active region coincides with text box/image 
borders, but can also be customized with user-specified coordinates and borders, such as 
borders being outside, inside, or nonexistent and having specified direction and 
thickness). To implement and allow the user to test those types of force effects in which 
the location on the screen of the graphical representation needs to be known (e.g. for 
enclosures, attraction/repulsion forces, etc. such as shown in Fig. 19c), the design tool 
palettes 522 work directly in the application's client coordinates (i.e. the window of the 
palette) with a conversion function to provide full screen coordinates that are typically 
used directly with an API and force feedback mouse (similar to the coordinate conversion 
described with reference to Fig. 8). Interface buttons allow the user to experiment with 
different force effects when designing the effects for the web page object. Thus, the user 
can iteratively design force effects quickly and easily by testing the effects directly in the 
design interface. 

The application 520 outputs a force-enabled HTML file 523 which can be stored 
on a server and downloaded by a client machine. The force effect content (parameters, 
etc.) that were designed or modified in the force design palettes can be saved directly in 
the HTML file along with all the other text, graphics, and other non-force content, and no 
intermediate force effect files are required. In other embodiments, a force effect file can 
be created using the design palettes 522 and the produced HTML file can included 
reference the separate force effect files which are downloaded with or after the web page. 
For example, the HTML file can include Javascript which references a force-only 
ActiveX control, a media ActiveX control to enable any sounds, force effect files (unless 
force content is included in the HTML), and sound files. Other formats and 
implementations can also be used for the HTML file. In addition, there can be an option 
provided in the authoring tool to allow standard HTML code to be generated without 
force information. 

FIGURE 26 illustrates an alternative embodiment of a force feedback web page 
authoring tool, in which a stand-alone force design application 524 is provided which 
only is capable of designing feel sensations, and a stand-alone force-enabled web 
authoring tool 526 for designing the web page including graphics, text, and links is 
separately used. The force design application 524 includes a feel editor with graphical 
controls, such as shown above in Figures 18 and 19, where the user can design force 
effects and adjust parameters to test the effects. An example of such an editor is 1-Force 
Studio from Immersion Corp. The parameters can include effect type, magnitude, 
direction, type-specific parameters (e.g. frequency, spacing), and duration. Screen- 
Docket No. IMMIP062 

-51 - 



position force effects such as enclosures are referenced in client (window) coordinates, 
which are readily portable to other applications after converting them to full screen 
coordinates. The application 524 can save out force effects as force effect files 528, 
which can be standardized with a file extension (e.g. "IFR"), for example. 

The separate web authoring application 526 references one or more force effect 
files 528 that were created by the force design application 524. The web authoring 
application provides a force-enabled HTML editor in which web page objects may be 
assigned force properties. The application 52,6 allows a web page object to be assigned a 
force effect stored in the force effect file 528 that was designed in the design application 
524, and to associate sound files with the force effects. For example, the editor of Figs. 
17a or 17b can be utilized as the standalone application 526 that imports a resource file 
including one or more force effects as shown in Fig. 17b. If a user wishes to design or 
edit a force while the authoring tool 526 is running, the force design application can 
immediately be run and displayed as well. The authoring tool of the present invention 
thus includes seamless web authoring integration with other force feedback design tools 
such as I-Force Studio. 

Application 526 is used to save a web page 527 in HTML code, where the web 
page 527 includes tags or references to force effect files and sound files, much the same 
way that standard HTML includes references to image files. Alternatively, the HTML 
file can include the force content as described' above. In one preferred embodiment, the 
application 526 saves an HTML file including Javascript code, references to used 
ActiveX controls, a name of a force effect file and a name of a force effect within the file, 
and a name of a sound file (if applicable). The Javascript code preferably accesses a 
force-only ActiveX control to enable forces (as described above) and, for example, 
accesses a different media ActiveX control (such as ActiveMovieControl from Microsoft) 
to enable sounds when a user downloads the force-enabled web page. Events can be 
provided as event handlers in the HTML code that pass information to the JavaScript 
instructions. Other implementations can also be used, for example as described herein. 

The web authoring tool of Fig. 25 or 26 can use different implementations to add 
force effects to HTML code. For example, in one embodiment, the authoring tool takes 
an existing HTML document (or creates a new document), internally uses Dynamic 
HTML to obtain object information and add force effects. As explained above, the 
authoring tool can output a web page in normal HTML including additional code for 
implementing the force effects (such as JavaScript which calls a force-only ActiveX 
control). 
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When a web browser of a client machine is used to download the force-enabled 
web page produced by authoring tool of Fig. 25 or Fig. 26, the browser parses the HTML 
and JavaScript to display the web page and implement the forces and sounds. The 
ActiveX controls referenced by the JavaScript are typically already resident on the client 
machine or may be downloaded as needed. The force effect files and sound files 
referenced in the HTML are downloaded (similarly to downloading any referenced 
images in standard HTML) or may already be resident on the client. 



End User Customization of Feel Content 

Another type of force , design capability can be provided to allow an end user, 
rather than just an author of a web page, to customize force effects for all web pages or 
for a particular web page. The generic force effects described herein allow end users to 
experience generic feel sensations for web page objects of a particular type. For example, 
all hyperlinks can feel like gravity wells, and all images can feel like a glass surface. 
Ideally, the user on a client machine should be able to adjust the set of generic feel effects 
to suit his or her preferences. For example, the user may want all hyperlinks to generate a 
vibration instead of a gravity well. Customization ability already exists in most browsers 
for characteristics like the color of hyperlinks- the web browser automatically assigns the 
hyperlink a color based on the user preference. However, web authors can override those 
default colors to make the hyperlinks match a web page's color scheme. Two possible 
ways of allowing end users to customize the set of generic feel effects are described 
below. 

One method is to allow the user to adjust user preferences with a central control 
panel, either associated with their local GUI force preferences, or with the Web browser 
preferences. This control panel could allow a force file to be specified as the desired 
force effect for a specific type of web page object. The force file can include all the 
parameters and data necessary to characterize the desired force effect. In addition, a force 
file can specify force effects for a whole set of different web page objects, or all the 
objects on a particular web page. Furthermore, in some embodiments as described above, 
different sets of generic force effects can be specified for different web pages. Thus, a set 
of generic force effects could apply only to a particular associated web page. 

Another method for feel customization is to encapsulate all the force design 
functionality in an ActiveX object (or other programming construct) embedded in the 
HTML page, as described in greater detail above. In this case, any user browsing a web 
page with the Force Design ActiveX object embedded within has the force design tools 
readily available to customize all the feel content on the web page. The user would not 
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need to have a force design web authoring interface or a force-enabled web authoring 
application installed to perform this customization. For example, a web page that 
includes a texture and a vibration references a force-only ActiveX object that enables and 
outputs these two forces on the client machine. A user interface can also be included in 
the ActiveX object downloaded to the client machine to allow a user to edit the texture 
force or the vibration force. The user interface need not be fully functional, since it is 
downloaded with the web page (and bandwidth may need to be conserved); and the user 
interface need not enable the user to edit/design all possible or even most types of forces, 
just the forces provided on the web page with which it is included. Alternatively, a more 
fully functional user design interface can be provided in the downloaded ActiveX object. 

The authoring tools described herein have focussed on allowing web content 
authors to easily add compelling feel content to their HTML pages. These HTML pages 
would then be seen, heard, and felt by end users over the WWW. However, end users 
may also be interested in using these tools, even though they may not be authoring web 
pages. For end users, these tools can also offer a means of customizing the feel content in 
existing web pages to suit their preferences. Such a feature is relevant in light of the fact 
that some browsers, such as Microsoft's Internet Explorer 4, provides an "Active 
Desktop" , which treats the entire operating system on the client machine as a web page. 
Therefore, the web page authoring tools can conceivably be used to customize the feel of 
files, folders, icons, scroll bars, buttons, windows, and other objects displayed in a GUI 
of an operating system. 

While this invention has been described in terms of several preferred 
embodiments, there are alterations, permutations, and equivalents which fall within the 
scope of this invention. It should also be noted that there are may alternative ways of 
implementing both the process and apparatus of the present invention. For example, 
although specific reference is made to the World Wide Web, the features of the present 
invention can be provided with use of other networks and network protocols. In addition, 
the features described herein can be combined partially or wholly with one another if 
desired to achieve a desired particular implementation. 
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APPENDIX A 
Source code implementing generic effects in a web pag 
using dynamic HTML: snap enclosures on links. 

frmBrowser.fmi 

VERSION 5.00 

Object - «'{6B7E6392-850A-101B-AFCO-4210102ABDA7)Hl.2flO"/ 
"COMCTL32 .OCX" 

Object - "{EAB22ACO-30Cl-llCF-A7EB-00O0CO5BAE0B)»l.lB0"; 
•SHDOCW.DU," 
Begin VB.Fprm frmDrowQer 
ClientHeight - 7632 
ClientLeft - 1548 

CUentTop ' 1332 
ClientWidth - 9120 

LinkTopic - *Porml" 

ScaleHeight - 7632 

ScaleNidth - 9120 

ShowInTaskbar - 0 'False 
Begin VB. Timer timTimer 

Enabled - 0 • Faloe 

Interval - 5 

Left - 7320 

Top » 1B00 

End; 

Begin SHDocVwCtl .WebBrowser brwwebBrowser 
Height - 6B64 

Left - 12 

Tab index m 0 

Top - 25 

Width - 9684 

ExtentX - 17082 

BxtentY - 12107 

ViewMode - 1 

Offline - 0 

Silent 0 
RegieterAaBrowBer- 0 
RegisterAsDropTarget- 1 
AutoAr range - -1 'True 

HoCl lent Edge - 0 'False 
AlignLeft « 0 'False 

ViewID 
08002B2B1262)" 
Location 

End 

Begin VB. PictureBox picAddress 



• {0057O0E0-3573-11CF-AE69- 



Allgn 
BorderStyle 
Height 
Left 

ScaleHeight 
ScaleWidth 
Tab Index 
Tabs top 
Top 
Width 



1 'Align Top 
0 ' None 
7B0 
0 

780 

9120 

1 

o 'False 

0 

9120 



End 

Begin ComctlLib . ImageLlst iml Icons 
Left - 7080 

Top - 1000 

JBxtentX » 804 

~ExtentY » 804 

BackColor » -2147483643 

ImageWidth 2 4 

ImageHeight » 24 

MaokColor • ' 12632256 

_Veraion - 327682 

BeginProperty Images {0713E8C2-850A- 101B- AFC0 - 
4210102A8DA7) 

HumList Images ■ 8 

BeginProperty Listlmagel (0713B8C3 - B50A- 101B-AFC0- 
4210102ABDA7) 

Picture » "CrmBrowser .frx" 1 0000 

Key "" 
EndProperty 

BeginProperty Listlmage2 (0713E8C3-850A-101B-AFCO- 
4210102A8DA7 } 

Picture - " CrmBrowser . f rx" t 0712 

Key 
EndProperty 

BeginProperty Listlmage3 (0713E8C3 -850A-1O1B- AFCQ- 
4210102A8DA7} 

Picture 

Key 
EndProperty 

BeginProperty LiBtImage4 (0713E8C3- 850A-101B-AFCO- 
4210102A8DA7) 

Picture 
Key 
EndProperty 

BeginProperty LiotlinageS (0713B8C3-850A 101B AFC0- 
4210I02A8UA7) 

Picture 
Key 
EndProperty 



CrmBrowser. frx" t0E24 



f rmBrowser . f tx n 1 1536 



CrmBrowser . frx" ilC48 



BeginProperty Liatlmagee {0713B8C3-8S0A-101B-AFC0- 
42101O2ABDA7) 

Picture - *f rmBrowser . Crx" i 2 35A 

Key - 
EndProperty y 

BeginProperty Liatlmage7 (0713EBC3- 850A-101B-AFC0- 
4210102A8DA7} 

Picture » "CrmBrowser . frx" i 2 A6C 

Key - " " 

EndProperty 

BeginProperty List ImageB { 0713E8C3 - 8 50A-101B- AFC0- 
4210102A8DA7) 

Picture - "frmBrovBer.erx" i2EC2 

Key - » ■ 

EndProperty 
EndProperty 

End 

End 

Attribute VB_Nama » "C rmBrowser" 
Attribute VB_GlobalNameSpace « Faloe 
Attribute VB_Creatable - False 
Attribute VB_PredeclaredId a True 
Attribute VB_Expoeed - False 

Public WithEvents IEDocEvente As HTMLDocument 
Attribute IEDocEvente .VB_VarHelpID • -1 
Pubjtic Start ingAddresa As String 
Dim mbDontNavigateNow As Boolean 
Dim navigating Ab Boolean 



•** Form Loading and Unloading Event Handlers 

Private Sub Form_Load() 
On Error Resume Next 

' Play with the address line and beginning navigation 
StartingAddress - 
"file«//Ci \COMD EX \PTWDemo\yahoo\ yahoo .html" 
If Len (StartingAddress) > 0 Then 

' Try to navigate to the starting address 

timTimer .Enabled « True. 

b rwWebB rows er. Navigate StartingAddress 
End If 

• Get us visibly ready 
Me . Show 

tbToolBar .Refresh 
Form_Resize 

' Set up Serra 
Dim result As Long 

result - Serra. CreateSerra(App.hInstance, 
f rmBrowser .hWnd J 

I£ (result - 0) Then 
Unload CrmBrowser 

End If 
End Sub 

Private Sub Form_Un load (Cancel As Integer) 

Dim result As Long 

result ■ Serra. DestroySerra { ) 
End Sub 



'** Web Browser Events 

Private Sub brwWebBrowser_Bef oreNavigate2 (ByVal pDiop As 
Object, URL As Variant. Flags Aa Variant, TargetFrameName As 
Variant. PostData As Variant. Headers As Variant. Cancel As 
Boolean) 

On Error Resume Next 

Set IEDocEvente - Nothing 

Call Serra. StopTouching 

navigating - True 
End Sub 

Private Sub brwWebBrowaer_NavigateComplete2 (ByVal pDisp Aa 
Object, URL As Variant) 

' Play with the address line 

Dim i As Integer 

Dim bFound As Boolean 

Me. Caption - brwwebBrowser .LocatlonName 
• Bind the document 

Set IEDocEvente « brwwebBrowser .Document 

navigating *> False 
End Sub 

Private Sub brwWebBrowBer„DownloadComplete () 
On Error Resume Next 

Me. Caption - brwwebBrowser . LocatlonName 
End Sub 



'•* IEDocEvente, etc. Handlers , 
•Private Sub I EDoc Even ts_onmou Be down ( ) 

' IC brwwebBrowser .Document .parentwindow. event .Button ■ 4 
Then 

• Call Serra .StopTouching 

1 Call Serra. StartPushScrolling 



Docket No. IMMIP062 



-55 



14 

13 

1 4 
iff 

£V6 



o 
w 

{•3 

in 

Ml 



End If 
'End Sub 

'Private Sub Form Mouseup (Button Ao Integer, shift As 
Integer, X Ab Single, Y As Single) 
• Call Serra .StopPuahScrolLing 
• Call Serra. St artTouching 

* Bnd Sub 

• Private . Sub IEDocEvents_onmouseup ( ) 

• Cali Serra, StopPuehScrolling 

* Call Serra. Star tTouching 
•End Sub 

Private Sub IEDocBvents onmouaeover ( ) 

♦ The meat of it all! I I 

Dim reault Ab Long 

ie (Hot navigating) Then 

reault - Serra .TryTouching (ByVal 
brwMebBrowser .Document .parentwindow. event) 

End If 
End Sub 



Address, Toolbar, and Form Event Handlers 

Private Sub Form Resize () 

brwWebBrovser. Width - Me.ScaleWidth 
brwWebBrowser .height - Me.ScaleHeight 

End Sub 

Private Sub timTimer_Timer ( ) 

If brwWebBrowaer .Busy - False Then 
timTimer .Enabled - Faloe 
Me. Caption - brwWebBrowaer . LocationName 

Else 

Me. Caption - "Working..." 
End If 
End Sub 



Serra.odl 



i 

uuid<819BDOEO-57BE-lldl-A8 60-OO6OO8 3A2 74 2) , 
lcid (0) , 

helpstring ("FeelTheWeb. DLL" ) , 

version (0.9) 

I 

library PeelTheWeb 
{ 

ffdefine DLLAPI stdcall 

import lib ( "mshtml .dll" ) ; 

I 

UUid (8 19BD0El-578E-lldl-A868- 0O600B3 A2742 ) . 

helpstring ("Basic serra Functions"), 

dllname( "FeelTheWeb.dll") 

J 

module Serra { 

I 

entry("CreateSerra") , 

he lpotring ( "Creates a connection to the 
Serra device. Requires the application's instance handle 
and window handle. Returns 0 if unsuccessful."), 

) 

long DLLAPI CreateSerrat long theHINST. 

long theHWND ) ; 

I 

entry ( ^DestroySerra" ) , 

helpstring ("Destroys a connection to the 
Serra device. Returns 0 if unsuccessful."), 
1 

long DLLAPI Des troySer ra ( ) ; 
I 

entry ( "TryTouching") , 

. helpstring ( "Checks if the given event 
touches a touchable element, and if so creates a Serra 
enclosure for it."), 

1 

long DLLAPI TryTouching ( (in J 
IHTMLEventObj* theEventPtr ) ; 

\ . 

entry ( "StartTouching" ) , 

helpstring ("Enables Serra' s ability to 



touch elementB .") , 



touch elements . ") , 



I 

void DLLAPI StartTouching () ; 
I 

entry ( "StopTouching" ) , 

Helpstring ( "Disables Sena's ability to 
I 



void DLLAPI StopTouching ( ) ; 
I 

entry ( "S tart PushScrol ling" ) . 
helpstring ("Enables the spring affect 
for push scrolling."), 
1 
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void DLLAPI StartPushScrollingO ; 
1 

entry ( -StopPuehScrolling" ) , 
helpstring! "Disables the spring effect 
for push scrolling."), 
1 

void DLLAPI StopPushScrollingO/ 



} 



) 



Serra.def 

LIBRARY FeelTheWeb 



CreateSerra 

DestroySerra 

TryTouching 

StartTouching 

StopTouching 

Start PushScrolling 

StopPushScrolling 



Wrapper.h 



* FeelTheWeb.dll 

* (c) 1997 Immersion Corporation 
# 

* FILE 

* Wrapper.h 

* DESCRIPTION 

* c+4 functions for the FeelTheWeb visual Basic program. 

* These are placed in a DLL, 

* It provides access to MSHTML and the Serra API. 
W 

tfifndef ^WRAPPER H 
fldefine _WRAPPBR~H~ 
ttinclude "StdAfx.h* 
{(include "mshtml. h N 
» include "vbutil.h" 



typedef enum 
{ 

teCant Touch - 0, 
teAnchor, 
// teArea, 7 
teButton, 
telnputButton, 
teinputCheckBox, 
telnputlmage. 
telnputText, 
telnputRadio, 
// teMap, 7 
teTextArea 
) TouchEiem; 

// For DLL (public) 

long DLLAPI CreateSerrat long theHINST, long theHWND ); 
long DLLAPI DestroySerra () / 

long DLLAPI TryTouching ( IHTMLEventObj * theEventPtr ) ; 

void DLLAPI StartTouchingO ; 
void DLLAPI StopTouching () ; 

void DLLAPI StartPushScrollingO; 
void DLLAPI StopPushScrollingO; 

// Not For DLL (private) 

void _DoEnclosure( IHTMLEventObj * theEventPtr, I HTMLElement * 
theElem ) ; 

TouchEiem JTryTouchingHelper ( IHTMLElement* theEl, 
IHTMLEventObj* theEventPtr )/ 

TouchEiem _Che ck I £ Touchable ( IHTMLElement * thoEl); 
Nendif WRAPPER H 



Wrapper.cpp 



.* FeelTheWeb.dll 

* (c) 1997 immersion Corporation 

* FILE 

* Wrapper.cpp 

* DESCRIPTION 

* O* functions cor the PeelTheWeb vioual Basic program. 

* Theee are placed in a DLL. 

* It provides access to MSHTML and the Serra API. 
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it include "StdAfx.h" 

II include "comdef.h" 

0 Include <stdio.h> 

0 Include "Wrapper. h" 

(I Include "PorceSerraMouae .h" 

((include "ForceSpring .h" 

fl include ■ForceEncloQure.h ,, 

H include "ForcePeriodic .h" 



/* 



GLOBAL VARIABLES*/ 



CForceSetraMouHe* gSerraMouse - MULL; 
CForcePeriodic*gEnclosureSnap - NULL; 
CForceEnclosure*gAnchorEncloBure - NULL; 
CForceSpring*gPushSpring «• NULL; 

flifdef DI RECTI NPUT_VERS ION 

const QUID guidSquare -QUID Square; 

fjelee 

const GUID guidSquare - GUID_8erra_Square; 

ttendif 

/* Force Effect Parameters */ 
// Pop Effect 

DWORD PDIRX-O, PDIRY-O, PDUR-100, PNAG-2000, PPER-lOOi 
// Enclosure 

DWORD ESTIFFH-8000, ESTIFFV-8000 , EWWH-fl. EWWV-8, 
ESATHolOOOO, ESATV-10000; 
// Spring 

DWORD SSTIPP-8000, SSAT-10000. SDEAD-5; 
// Use pop? 
DWORD USEPOP - 1; 



/«****•**************** ***** *«***«»**«**•»******< 

/* PUBLIC FUNCTIONS */ 

long DLLAPI CreateSerra( long thelllNST, long theHWND ) 



t 



RBCT encRect < { o, o, loo. 100 ); 
BOOL SucceSB; . 



// Try to get parameters from FTWfx.dat 
PILE *£p ■ fopen( "FTWfx.dat", "r") ; 
if (fp) { 

// Pop Effect 

fscanf (fp. n %d %d %d %d Id", &PDIRX, 
&PDIRY, 6PDUR, &PMAG; 6PPER )/ 

// Enclosure 

fscanf (fp. "Id %d %d %d Id %d". fcESTIFFII, 

&ESTIFFV. &EWHH, &EWWV, SESATH. &ESATV ) ; 

// Spring 

f acanf (fp, «%d %d Id", 6SSTIFP, fcSSAT, 



&SDEAD ) i 



) 



// Use snap? 
fscanf (fp, "Id" 
// Close it . . . 
f close ( fp) ; 



&USEPOP ) ; 



// Initialize the SerraMouse 
gSerraMouse - new CForceSerraMouse; 

if ( ! gSerraMouse ) goto CS_Err; 
success * gSerraMouae->Initialize(~(HINSTANCB) theHlNST. 
(HWND) theHWND ); 

if ( I success ) goto CS_Err; 

// Create the effects 

gEnclosureSnap - new CForcePer iodic; 
if ( ! gEnclosureSnap .) goto CS_Err; 
succeSB o gEnclooureSnap-> Initialize ( 

gSerraMouse, 

guidSquare, 

CPoint(PDIRX, PDIRX) 

PDUR, 

PMAG, . 

PPER 



// Direction 
// Duration (ma) 
// Magnitude 
// Period (ms) 



if ( 



I success ) goto CS_Err ; 



gAnchor Enclosure «• new CForceEncloaure ; 

IE ( I gAnchorEiicloauro ) goto CS_Err, 

success » gAnchorEncloBure- > Initial ize ( 

gSerraMouse, // CForceDevice* pDevic-e, 
CencRect, // LPCRBCT pRectOutside, 
ESTIPFH, // LONG lHorlzSt if f ness, 
ESTIPFV, // LONG lVertS t i f f ness, 
EWWH, // DWORD dwHorizWallWidth, 

EWWV, // DWORD dwVertWallWidth, 

BSATH, // DWORD dwHoriaSaturation. 
ESATV, // DWORD dwVert Saturation. 
SERRA_FSTI FF_0UTBOUNDANYWALL , 

// DWORD dwstif fnessMask, 

0x0, // DViORD dwClippingMask, 

NULL // CForceCondition*pInsideCondition 

if ( I success ) goto CS_Err; 

gPushSpring » new CForceSpring; 
if ( ! gPushSpring ) goto CS_Err; 
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} 



success » gPuahSpring->Initialise( 
gSerraMouse, 
SSTIPF, 
8SAT, 
SDK AD, 

force e ff ect_ax 1 3 both, 
force""spring_default_center_point 

); 

if ( ! success ) goto CS_Brr; 
return 1; 

// We had problems... clean up and leave. 
DestroySerra ( ) ; 
return 0,- 



long DLLAPI DestroySerra ( ) 

if ( gSerraMouse ) { delete gSerraMouse; 
gSerraMouse » NULL; ) 

if ( gEnclosureSnap) { gEnclosureSnap- >Stop O ; 
delete gEnclosureSnap; gEnclosureSnap - NULL; ) 

if ( gAnchor Enclosure } ( gAnchor Enclosure - 
>Stop() ; delete gAnchor Enclosure; gAnchorEnclooure- NULL; 

if < gPushSpring ) { gPushSpring- >Stop( ) ; 
delete gPushSpring; gPushSpring « NULL; } 

return 1; 
) 



long DLLAPI TryTouching( IHTMLBventOb j * theEventPtr ) 

long result - 0; 

IHTHLElement* pBl; 
TouchElem te; 

// Get the srcElement 

theEventPtr- >get_a rcElement { fcpEl ) ; 
if ( pBl ) 



I 



» 



// Chech if its touchable 

te » _TryTouchingHelper ( pEl, theEventPtr ); 

if ( te I» teCantTouch ) 

{ 

//Create enclosure for element... 
JDoEnclosure( theEventPtr", pEl ); 
result - 1; 

) 

pEl- >Release ( } ; 



return result; 

void DLLAPI StartTouchingO 

if ( gAnchorBnclosure ) gAnchor Enclosure ->S tart () ; 



void DLLAPI StopTouchingO 

if ( gAnchorEnclosure ) gAnchorEnclooure- >Stop ( ) ; 

if ( gEnclosureSnap ) gEnclosureSnap- >Stop () ; 



void DLLAPI StartPushScrollingO 

if ( gPushSpring ) gPushSpring- >Start () ; 

void DLLAPI StopPushScrollingO 

if ( gPushSpring ) gPushSpring- >Stop () ; 



/* PRIVATE FUNCTIONS 



*/ 



TouchElem JTryTouchingHelper ( IHTMLElement* theEl. 
IHTNLBventObj* theEventPtr ) 



IHTMLElement* 
TouchElem 



pEl; 
te; 



// Our base case 

if ( theEl NULL ) 



return teCantTouch; 



// Is this guy touchable? 

te - _check If Touchable ( theEl ) ; 

if ( te I- teCantTouch J 

( 

return te; 

} 

//not touchable, try his parent I (if he has one) 
theEl ->get_parentElement< tpEl ) ; 
if ( pBl !• NULL ) 
{ 
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theEventPtr ) ; 



I* 



m 

14 

in 



13 
W 



If! 
llj 



te » _TryTouchingHelper ( pEl # 

pEl ->ReleaBe ( ) ; 
return te; 



return teCantTouch; 



/* DoEncloaure 

* inputi IHTMLEventOb j * , IHTMLBlement * 

* returns i void 

* Given an event object and an element, creates an 
enclosure 

* for that element. Hie event object Is for ascertaining 
the screen coordinates of the element. 

*/ 

void _DoEnclosure( IHTMLEventOb j ♦ theEvent, IHTMLElement* 
theElem ) 



{ 



RECT 
long 



temp; 



// Process left 

theElem->get_of £setLe£t( fi(r.left) ); 
theEvent->get_ocreenX ( ttemp ) ; r.left +- temp; 
theEvent- >get_of f setX ( ttemp ); r.left temp; 

// Process top 

theElem->get_o£ fsetTopf Mr. top) ); 

theEvent- >get_screenY ( ttemp ); r.top ♦» temp; 

theEvent- >get_of fBOtY ( ttemp )/ r.top -■ temp; 

// Process right and bottom 
theElera->get__o££setWidth( Mr. right) ); 
r. right ♦ - r.left; 

theEleni- >get_o£f seUleight ( Mr. bottom) ); 
r. bottom ♦« r.top; 

// Calculate wall widths and heights 
DWORD hww - (r.rlght«r.left+l)/2; 
dhord vww » <r.bottom-r.top+l)/2; 
lf ( hww < EWWH ) 
hww--; 

else 

hWW - EWWH; 

if ( vww < EWWV ) 
vww-- ; 

else 

' vww » EWWV; 

// Make the enclosure 
if (gAnchorEnclosure) 
{ 

gAnchorEnclosure ->ChangeParameters ( 
&r, 

FORCB_BFFECT_DQNT_CHANGB, 
FORCE~EFFECT_DONT_CHANGE , 
hww, 
vww, 

F0RCE_EFFECT_DONT_CHANGE , 
FORCEPS FFECT_DONT_CHANGE , 
FORCE_BFFECT_DONT_CHANGE , 
FORCE_EFFECT_DONT_CHANGE, 
(CForceEfEect*) 

FORCE BFFECT_DONT_CHANGE 

); 

gAnchorBnclosure->start () ; 

if ( USEPOP ) 

( 

gEncloaureSnap~>Start ( ) ; 
7/ gEnclosureSnap->Stop ( ) ; 

) 

} 

) 



TouchElem ChecklETouchable ( IHTMLElement * theEl) 



IHTMLBlement* 



pUnk; 



// Is it an Anchor? 

theEl ->Query Interface { II D_ I HTMLAnchor Element , 
(LPVOID*) SpUnk ) ; ' 

if ( pUnk ) ( pUnk->Release<) ; return teAnchor; 

) 

// teArea,? 
// teMap.? 

// Is it a Text Area? 

theEl ->Query Inter face ( I ID_IHTMLTextAreaEletnent, 
(LPVOID*) tpUnk ) ; 

if ( punk ) { pUnk->Release () ; return 
teTextArea; ) 

// la it a Button? 

theEl- >Query Interface ( I ID_IHTMLButtonElement . 
(LPVOID*) bpUnk >; 

if ( pUnk ) { pUnk->Release () ; return teButton; 

) 

// Is it an Input Button? 
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theEl ->Query Interface ( 
IID_IHTMLlnputButtonBlement, (LPVOID- ) spUnk ); 

if ( pUnk ) ( pUnk->Release O ; return 
telnputButton; ) 

// Is it an Input Check Box?. 
// theBl->Queryinterface( 

IID^lHTMLInputCheckBoxBlement, (LPVOID* ) tpUnk ); 
// if ( pUnk ) { pUnk->Release() / return 

te Input Che ckBox; } 

// Is it an Input Image? 
// theEl -aQuerylnterf ace ( I ID_I HTMLI nput I mage Element , 

(LPVOID*) tpUnk ) ; 

// if ( punk ) { pUnk->Release () ; return 

tel nput Image; } 

// is it an Input Text? 

theEl- >QueryInter facet I ID IHTMLInputTextBlement, 
(LPVOID* UpUnk ); 

if ( pUnk ) { pUnk ->Re lease () ; return 
telnputText; ) 

// Is it a Input Radio Button? 

theEl - ?Query Interface ( 
IID_IHTMLOptionButtonElement, (LPVOID* ) fcpUnk )/ 

if ( punk ) { pUnk->Release() / return 
telnputRadio; } 

// Hone of the above) 
return teCantTouch; 



TouchCheck.h 

// TouchCheck.h i interface for the CTouchCheck class. 
// 

///////////////////////////////////////////////////////// 
ffif 

I defined (AFX_TOUCHCHECK_H E856BF20_4BAC_11D1_A868 0060083A2 

742_IHCLUDED ) 
«de£ine 

AFX_TOUCHCHBCK_H E8568F20_4BAC_11D1_A668_0060083A2742 IHCL 

UDED_ 

flif _MSC_VER >- 1000 
flpragma once 

fleridif // _MSC_VER >- 1000 

ftlnclude "♦StdAfx.h' 1 
^include <a£xtempl.h> 
^include •'mshtml.h" 

typedef enum 
{ 

teCantTouch • 0, 
teAnchor, 
// teArea,? 
teButton, 
telnputButton, 
teinputCheckBox, 
te Input Image, 
telnputText, 
telnputRadio, 
// teMap,? 
teTextArea 
} TouchElem; 

typedef struct 
{ 

RECT frame; 
TouchElem kind; 

) TRECTi 



class CTouchCheck 



{ 

public i 



right, 



static long p_mTouchProtected; 
void SetScreenToClient ( long Xval, long Yval ); 
void SetScrollVal ( long left, long top ); 
void SetClientRect ( long left, long top, long 
long bottom ) ; 



theAll ) ; 



int TryTouchingt long mX, long mY ) ; 

void FillTouchableo ( IHTMLBlementCollection* . 

static TouchElem Check! f Touchable ( IHTMLBlement* 



theBl) ; 



static void EnableTouching ( int touching ); 
static long IsTouchingBnabled ( ) ; 
static long isReadyToTouch ( ) ; 

CTouchCheck ( ) ; 
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virtual -CTouchCheck ( ) ; 

protected! 

C A r r ay < TR ECT , TRECT&> *p_mTouchables; 
RECT p_mClientRect; 
lnt p_mTouchableSiie; 
tnt p_mCut rent Index / 

ota tic long p_mReadyToTouch; // 
Internally Controlled 

static long p_mTouching Enabled; 

// User Controlled 

lnt p_mClientRectBpecif ied; 

long p_mScrollLef t; 

long p_mScrollTop; 

long p_mScreenToClientX; 

long p_mScreenToClientY; 

private. 

void _Ge tTouchable Frame ( IHTMLElement* theBl, 
RECT* theRect)/ 

void JTraneformPrameCorner ( IHTMLElement* theBl, 
long* left, long* top )/ 

static void _copyRect( RECT* from, RECT* to ); 

void _copyRectWithOf f set ( RECT* Crow, RECT* to ) ; . 

static lot _outside( RECT* theRect, long theX, 
long theY) ; 

etatlc int _inaide( RECT* theRect. long theX, long 

theY)/ 

void CTouchCheck i i_clipRectToClientRect ( RECT* r 

) ; 
); 

«endif // 

!deeined(AFX_TOUaiCHECK_H__E8568F20_4BAC_llDl_AB68_00600Q3A2 
742 IIJCLUDED_) 



TouchCheck.cpp 

// TouchCheck . cpp i implementation of the CTouchCheck class. 
////////////////////////////////////////////////////////// 

ft include "TouchCheck. h" 
//Hnclude <winbase.h> 
8 include <comdef.h> 
//Sinclude "OutData.h" 
//B include "FeedBack.h" 



//extern CFeedBack* 
RECT 



gjpFdBk; 
g_rcOb j ; 



// Static Members 

long CTouchCheck i i p_mTou chi ng Enabled « 0/ • 
long CTouchCheck i i p_mReadyToTouch - 0; 
long CTouchCheck t »p_mTouchProtected m 0; 



I nt erlockedExchange ( 



InterlockedExchange ( 



// Macro 

H define _ResetReadyToTouch ( ) InterlockedExchange! 
tp_mReadyToTouch, 0 > 
fldefine _SetReadyToTouch ( ) 
6p_mReadyToTouch, 1 ) 
U define _ResetTouching Enabled ( ) 
fcp_mTouchingEnabled. 0 ) 

tfdefine SetTouchingEnabled ( ) InterlockedExchange < 
ftp mTouching Enabled, 1 ) 

Hdeeine _ResetTouchProtected( ) InterlockedExchange ( 

tpjnTouch Protected, 0 ) 

it define _SetTouchProtected ( ) InterlockedExchange ( 
&p_mTouch Protected, 1 ) 

///////////////////////////////////////////////////////// 
// Construction/Destruction 

////////////////////////////////////////////////////////// 

CTouchCheck t i CTouchCheck ( ) 

{ 

p_mTouchableo - new CArray<TRECT, TRECT&* / 
p_mTouchableSize ■ -1; 
p~mCur rent Index « -1 j 
p_mCllentRectSpeci£ied - 0; 
_ResetReadyToTouch() ; 
~ResetTouchingEnabled() ; 

) 

CTouchCheck i i -CTouchCheck ( ) 
{ 

UeBetReadyToToucb () # 
jlesetToucliitigBiiabledO / 

while { p_mTouchProtected l > Sleep(O); 
// Yield until resources are free 
delete pjnTouchablea; 



/*«****•* 

/•• Public Functions 

/*****•»**• * * 

void CTouchCheck i i PillTouchableo ( iflTMLBlementCol Lection * 
theAll) 
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HRBSULT hr/ 

TouchElem kind; 

long index, a 11 Length, 1/ 

VARIANT vindex. var2; 

LPD IS PATCH pDisp; 

IHTMLElement* pElem - HULL/ 

// IHTMLEleraentCollection* pAll - NULL; 

TRECT theTRect / 

// Clear out the previous touchablesl 
_ResetReadyToTouch ( ) # 
1 p_mTouchablea - >RemoveAll ( ) / 

// Grab our document -all interface... 
// hr - theAll ->Query Inter f ace( 

IID_IHTMLElementCollection, (LPVOID* ) tpAll )/ 
// if < hr — S OK ) 

// ( 

// Go through the list and onlykeep touchable ones 
index - -1/ 
' vindex. vt » VTJJINT; 
variantlniti fcvar2 ) / 
theAll- >get_length( fiallLength ); 
p_mTouchables->SetSize( allLength )/ 
for ( i-0; i < allLength/ i* + ) 
. ( 

// Get the element 

vindex. lVal - i; 

hr - theAll ->item( vindex, 



var2, fcpDiop 



>GueryInterf ace( IID_IHTMLElt 



if ( hr — S_OK ) 
{ 

hr - pDiep- 
ment. (LPVOID*) fipElem )/ 

if ( hr »- S_0K ) 
{ 



touchable, and if so, add it to the array 
Checklf Touchable (pElem) / 
teCantTouch ) 



// See if it's 
kind - 
if ( kind I- 
( 



index* +; 
theTRect. kind - kind/ 

Ge tTouchable Frame { pElem, t( theTRect . frame) ) ; 
p_mTouchablee-»SetAt ( index, theTRect )/ 



>Release() ; 



pElem- 

} 

pDisp->Release() ; 



// 



} 



} 



p_mTouchableSi«e » index/ 
p^mCur rent Index * -1/ 
_SetReadyToTouch ( ) / 



// mX and mY are in screen coordinates 

int CTouchCheck i . tTryTouching (long mX, long mY) 

// Check if we're ready for action I 
if ( ! (CTouchCheck t ip_mReadyToTouch (■& 
p_mClientRectSpecif ied && CTouchCheck i ip_mTouchingEnab led) ) 
return 0/ 

// Stop immediately If out of bounds... 
if ( _outside( ip_mClientRect, mX, mY ) ) 
return 0; 

// Transform mouse coordinates into client 
coordinates 

mX (p_mScreenToClientX - p_mScrollLeft) / 
mY (p~mScreenToClientY - p_mScrollTop ) / 

// Check everything in client coordinates! 
int index - 0/ 

TRECT aTR / 

while ( index <- p_mTouchableSize ) 

, aTR - p_mTouchablee ->Oet At (index) / 
if ( _inside( & (aTR. frame) . mX, mY ) ) 

// Is it the same one we're 

currently touching? 

if ( index -» p_mCurrent Index) 
return 0/ 

// Do Feedback on it... maybe 
later check its touchtype (kind) 

_copyRectWithOf feet ( 

MaTR.f rame) , t(g_rc0bj) )/ 

_clipRectToClientRect ( 

t (g rcObj ) ) / 

// ~ gjpFdBk->Enable( FB ID__TRBBITBJ1 



it 



p_mCur rent Index - index/ 
return 1/ 
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index* +; 



Q 

'ft* 

ill 

111 
m 



m 



long top, long 



return 0; 



void CTouchChecki iSetClientRect (long left, 

right, long bottom) 

{ 

p_mClientRect . left - left/ 
p_mCl lent Rec t . top » top; 
p~mClientRect . right - right; 
p_mClientRect .bottom - bottom; 
p_mClientRectSpeci£ied - 1; 



void CTouchChecki tSetScrollVal (long left, long top) 
{ 

_ResetReadyToTouch ( ) # 
p_mScrol lbef t - left; 
p_jnScrollTop = top; 
p_mCur rent Index » -1/ 
_SetReadyToTouch 0 / 



void CTouchChecki tSetScreenToCl lent {long Xval, long Yval) 
( 

p_mScreenToClientX « Xval; 
p mScreenToClientY « Yval; 

) 

void CTouchChecki t EnableTouching{ int touching ) 
{ 

if (touching) 

_SetTouchingEnabled() ; 

else 

ResetTouchingEnabledO ; 

) 

long CTouchCheck t 1 1 oTouchingEnabled ( ) 
{ 

return CTouchChecki ip_mTouchingEnabled; 

) 

long CTouchCheck i t IsReadyToTouch ( ) 
( 

return (CTouchCheck it p_mRe a dyToTouch && 
CTouchChecki ip_mTouching Enabled) ; 



* Private Functions 



void CTouchChecki !j3etTouchabl eFrame( IHTMLElement * theBl, 
RECT * theRect) 



{ 

// 



long 



left, top, right, bottom; 



theEl- >get_of fsetLeft ( & ( theRect- >left) ); 
theEl->get_o£f eetTop ( & (theRect -> top) ) ,- 
theEl->get_of£setWidth( MtheRect->right) ); 
theEl ->get_oEfsetHeight( & (theRect- >bottom) ); 

_TransformPrameCorner ( theBl, fc(theRect->lef t) , 
£ (theRect -> top) ); 

theRect->right +- (theRect->lef t ) ;. 
theRect ->bottom +- (theRect->top) i \ 

) 

void CTouchChecki i_TranBf ormFrameCorner ( IHTMLElement* 

theEl, long* left, long* top ) 

( 

long temp ; 

IHTMLElement* pEl; 

theBl ->get_o£fsetParent (( IHTMLElement** ) &pEl) ; 

if ( pEl I- HULL ) 

( 

pEl ->get_o£ fsetLeft ( fctemp ); 
•(left) +- temp; 
pEl->get_o£f set Top ( fctemp ) / 
*(top) +■ temp; 

Trans formFrameCorner ( pEl. left, top ); 
pEl->Release() ; 



TouchBlem CTouchCheck t i Check If Touchable (IHTMLElement * 

theEl) 

( 

IHTMLElement* pUnk; 
// Is it an Anchor? 

theBl ->Queiry Interface ( I ID_lHTMLAnchorElement , 
(LPVOID*) tpUnk ); 

if ( pUnk ) { pUnk->Release () ; return teAnchor; 



) 



// teArea.? 
// teHap.? 



// is it a Text Area? 

theEl ->QueryInter£ace ( IID_IHTMLTextAreaBlement. 
(LPVOID* HpUnk ) ; 

if ( pUnk ) { pUnk ->Rel ease ( ) ; return 
teTextArea; } 

// la it a Button7 

theEl ->Query Interface ( IID IHTMLButtonBleraent , 
(LPVOID* UpUnk ); 

if ( pUnk ) { pUnk-> ReleaseO / return teButton; 

} 

// Is it an Input Button? 

theEl - >Query Inter face ( 
IID_IHTMLInputButtonElement, (LPVOID* ) fipUnk ); 

if ( pUnk ) { pUnk- ^Release () ; return 
telnputButton; ) 

// // Is it an Input Check Box? 

// theEl ->Query Interface { 

IID_lHTMLInputCheckBoxElement, (LPVOID* ) fcpUnk ); 
// if ( pUnk ) { pUnk->Release() ; return 

telnputCheckBox; } 

// // Is it an Input Image? 

// theBl->QueryInterf ace { IID_IHTMLInputImageElement , 

(LPVOID* ) tpUnk ) ; 

// if ( pUnk ) ( pUnk->Release() ; return 

telnput Image; } 

// Is it an Input Text? 

theEl- >Query Interface ( IID_iHTNLInputTextElement, 
(LPVOID* ) &pUnk ) f 

if ( pUnk ) { pUnk->Rel eased ; return 
telnputText; } 

//,1a it a Input Radio Button? 

theEl - >Query Interface ( 
I ID_IIITMLOptionButtonBlement, (LPVOID* ) tpUnk ); 

if ( pUnk ) { pUnk->Release() ; return 
telnput Radio; } 

// Hone of the above I 
return teCantTouch; 



/** Utility Functions 

/********4*4*** « ft******************..**************** 

inline int CTouchCheck i t_inside (RECT* theRect, long theX, 

long theY) 

( 

if ( (theX>«theRect->le£t) it (theXotheRect- 
>right) fcfc 

(theY>-theRect->top) u 
( theY<- theRect ->bot torn) ) 

return 1; 

else 

return 0; 

} 

inline int CTouchCheck i i_out side (RECT* theRect, long theX, 
long theY) 



{ 

II 

>bottom) ) 
) 

inline void CTouchChecki i_copyRect (RECT * from, RECT * to) 



if i (theX<theRect->left) || (theX>theRect->right) 
(theY<theRect->top) || (theY»theRect- 
return 1; 
return 0; 



else 



{ 



to->le£t - from->left; 

to->right » from->right; 

to->top - from->top; 

to->bottom • f rom->bottom; 



inline void CTouchCheck i i_copyRectWi thOf f set ( RECT* from, 
RECT* to ) 

to->left - £rom->left ♦ (pmScreenToCllentX - 
p_mScrollLef t) ; 

to->right • £rom->right + (p_mScxreenToClientX - 
p_mScrollLef t) ; 

to->top - from->top + (p_mScireenToClientY - 
p_mScrollTop ) ; 

to->bottom « £rorn->bottom +■ (p_mScireenToClientY - 
p mScrollTop ) ; 
) 

inline void CTouchCheck • t_clipRectToClientRect ( RECT* r ) 
{ 

i£ < r->left < p_mClientRect.leffc ) r->left 
a p_mCl lent Rec t . le£t; 

if ( r->right > p_mClientRect . right ) r->right 
- p_mClientRect .right; 
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{15 
|* 
Ifl 



t -s 

m 

m 

£•■«* 



< p_mClientRect.top > r->top 

- p_tnClientR.ect-t.op/ 
if ( r->bottoin > p_mClientRecc. bottom ) r-*botta 

- p mClientRect. bottom; 
} 



IE ( r-»top 
p mClientRect .top; 
if ( 



Feedback.h 

// FeedBack.ht interface for the CPeedBack class. 
// 

///////////////////////////////////////////////////// 

Hifndef FEEDBACK_H 
H define FEEDBACK^ 

class CPeedBack ■ public CObject 

public i 

CPeedBack (); 
virtual -CPeedBack (} ,• 
static CPeedBack 'Created; 
void Enable (UINT nID) ; 
void Disable {UINT nID) ; 

private « 

BOOL Start SerraMouseFake (UINT period) ; 
void Stops erraMouse Pake (void); 

privates 

void CPeedBack i i BoundoCheck (RECT *r) ; 

int m_cyRes; 

int m_cxRee; 

BOOL initSuccess; 
HRBSULT timer ID; 

W 

tfendif // FEEDBACK_H 



Feedbackxpp 

// PeedBack.cppt implementation of the CFeedBack class. 
// 

///////////////////////////////////////////////////////// 

^include "atdafx.h" 
^include "outdata.h" 
# include <mmsystem.h> 
tf include <assert.h> 
^include <winbaae.h> 
(♦include "wincomm.h" 
llinclude "FeedBack.h" 
8 include "Touchcheck.h" 

ftifdef . _DEBUG 
Hundef THIS_FILE 

static char~THls_PlLEU- FILE ; 

Hdefine new DEBUQ_NEW 
Hendif 



^define PERIOD 
Hdefine SCREEN 
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// boolean variables for forces that roust be explicitly 

turned off 

Static BOOL fjpusliv scroll - FALSE; 

static BOOL f_wmss - FALSE; 

static BOOL f_dragging - FALSE; 

static BOOL f_hscrolling - FALSE; 

atatic BOOL f_vscrolling - FALSE; 

static BOOL f_menuitem •» FALSE; 

RECT g_rcOb j ; 

extern CTouchCheck* g_j>Touch; 

////////////////////////////////////////////////////// 
// Construction/Destruction 

///////////////////////////////////////////////////// 

CPeedBack i t CFeedBack () 

{ 

TRACED { ■ CFeedBack . i CFeedBack\n« ) ; 
timer ID - NULL; 
InitSucceoB « FALSE; 



m_cxRes 
m_cyRes 



GetSystemMetrics(SM_CXSCREEN) ; 
GetSystemMetricB(SM_CYSCREBN) ; 



Commlnit < > j 
// try' C0M1 thru COM4 
for (int i - 1; i <- <t if+) ( 
if (CommConnectU. 3B4001) ) { 

TRACE1 ("Connected on COM*d\n" , i) ; 
initSuccess - StartSerraMousePake ( PERIOD) ; 
break; 



I 



} 



I 



CPeedBack t i -CFeedBack ( ) 
{ 

TRACEO ("CFeedBack i i -CFeedBack\n" ) ; 

Disable (FB ID_OFF).; 
StopSerraMouseFakeO ; 
ComraEnd ( ) ; 



CFeedBack *CFeedBack • t Create ( ) 
( 

TRACE ( "CFeedBack 1 1 Create\n" ) ; 

CFeedBack *m_CFeedback » new CFeedBack (); 

if (m_CPeedback->initSuccess) { 

return m_CFeedback; 
}else{ 

delete m_CFeedback; 

return (NULL) / 

. I 

) 

void CFeedBack i t Bounds check (RECT *r) 
{ 

if(r->left < 0) r->left - 0; 
if (r->top < 0) r->top « 0; 

if (r->ricjhd > m_cxRee) r->right - m_cxRes; 
if (r->bottom > m_cyRea) r->bottom - m^cyRes; 



void CPeedBack i i Enable (UINT nID) 
{ 

unsigned char InBuf(lO); 
int CommSuccess - 0; 
RECT *r - NULL; 

InBuf (OJ o FBID ON; 

TRACE1 ("Enable called for FBID B%di", nID) ; 
switch (nID) { 

case 305 1 // TEXT SELECT 

- r » &g_rcOb j ; 
Bound s Check ( r) ; 

MW0RD *) (InBuf + 1) - (WORD) <r->lef t • SCREEN 

/ m cxRes) ; 

* (WORD *> (InBuf * 3) - (WORD) (r->top * SCREEN 

/ m_cyRes> ; 

if (CommSendMsg(nID, InBuf , S) ) TRACK ( w %d message 
sent, (%d. %d) \n«,nID. r->lef t r->top) ; 
else 

message failed **\n", nID) ; 
break; 

case 306 i // PUSH VSCROLL 

if ( I f_pushvecroll) 



TRACB1 {" ** %d 



r - tg rcOb j ; 
Bound s Check (r) ; 
*(WORD *) (InBuf ♦ l) 

» (WORD) (r-:. left * SCREEN / m_cyRes> ; 

f _puBhvBcroll » 

CommSendMeg (nID, InBuf, 3) ; 

if <f_r>ushvacroll) 
TRACE ( " %d message aent, %d\n" . nID, r->lef t ) ; 

else 

TRACE 1 ( " ** Id message failed **\n°, nID) ; 
}else{ 

TRACEO ( " FBIDPUSHVSCROLL al ready 

enabled\n" ) ; 

} 

break; 
case FBID_WMSZi 

f_wmsz - CominSendM8g(FBID WMSZ. InBuf , 1) ; 
if(f_wmsz) TRACE 0( M FB I D^WMSZ message sent \n") ; 
else TRACEO (" FBI D_WMSZ message failed\n") ; 

break; 

«if .0 

case FBlD_F0CUSi 

r ■» tg^rcWnd; 

BoundsCheck (r) ; 

* (WORD *) (InBuf + 1) 
SCREEN / m_CXRes) ; 

* (WORD *) (InBuf + 3) 
SCREEN / m_cyRes> ; 

* (WORD •) (InBuf ♦ 5) 
SCREEN / m_CXRes) ; 

* (WORD *) (InBuf ♦ 7) 
SCREEN / m_cyRes) ; 

if (CommSendMsg(FBID_POCUS, InBuf . 9) ) 

TRACE ( u FBID_FOCUS message sent 
(Id, %d. Id, Id) \n*. r->lef t, r->top, r- >right, r-»bottom) ; 

else TRACEO ( " FBID^FOCUS message £ailed\n"); 

flendif 

break; 
case FB I D^DRAGO I NG t 

it ( ! f_dragging) { 
f_dragging - 
Convive ndMsg(FB I DJ5ragG1NG, InBuf, 1) ; 

if (f_dragging) TRACEO (« FB ID_pRAGQINO 
message oent\n") ; 

else TRACEO < * FBID_DRAGGING 

message failed\n"); 



(WORD) ( (r->left * 2) * 

(WORD) { (xr->top ♦ 2) • 

(WORD) ( (i:->right - 2) * 

(WORD) ( (r->bottom -2) • 
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}else{ 

TRACSO < " FB ID DRAGGING already enabled\n" ) ; 

) 

break; 
case PBIDJISCROLLlNGi 

IE ( I £_hacrolling) { 

r m fcg_rcOb j ; 

BoundsCheck(r) / 

* (WORD M (InBuE ♦ 1) « (WORD) (r->le£t • 
SCREEN / m_cxRea) ; 

* (WORD *) (InBuE ♦ 3) « (WORD) (r- >Lop * 
SCREEN / m_cyRee) ; 

•(WORD * ) { InBuf + 5) « ( WORD) ( r- >r ight * 
SCREEN / mcxRes) ; 

•(WORD * ) (InBuf + 7) - (WORD) (r->bot torn* 
SCREEN / Ri_cyRea) ; 

£_h scrolling «» 
CommSendMsg(FBID_HSCROLLING, InBuE, 9) ; 

if (f^hec rolling) TRACEO ( "FBI DJISCROLL I NG 
message oent\n")/ 

elae TRACEO ( - FB I D_H SCROLLING 

message £ailed\n*); 
I 

break; 
caee PBID VSCROLLINGi 

if ( I f"__vscrolling) { 
r - tg_rcObj; 
BoundsCheck(r) ; 

* (WORD *) (InBuf ♦ 1) 
SCREEN / m_CxRes) ; 

* (WORD *) (InBuf + 3) 
SCREEN ./ m_cyRee> ? 

* (WORD *) (InBuf S) 
6CRBEN / m_cxRea) ; 

* (WORD *) (InBuf ♦ 7) 
SCREEN / tn_cyRes) ; 

£_vscrolling - 
CommSendMsg(FBID_VSCROLLlNG. InBuf, 9) ; 

i f ( f _vacrol ling) TRACEO ( " FBI D_VSCROLL I NG 
message sent\n") ? 



(WORD) (r->le£t * 
(WORD) (r->top * 
(WORD) (r->right * 
(WORD) (r->bottOm* 



elBe 

aaage failed^") ; 
) 

break; 



TRACEO ("FB ID VSCROLLING 



case 


FBID_LISTITEM» 


// 


2 


case 


PBID TREE ITEM i 


// 


3 


case FBID MENUITEMi 


// 


6 


case 


FBID_PUSHBTNi 


// 


10 


case 


PBID CLOSE t 


Jl 


402 


case 


FBID MAXBTNt 


// 


407 


caoe 


FBID_NINBTNi 


// 


408 


case 


FBI D_VSCROLL t 


// 


410 



6g_rcObj ; 
BoundsCheck(r) ; 

♦(WORD *) (InBuf ♦ 1) - (WORD) (r->left * SCREEN 

/ m_cxRes) ; 

* (WORD *) (InBuf 4 3) « (WORD) (r->top * SCREEN 

/ m_cyRes) ; 

•(WORD •) (InBuf + 5) - ( WORD) ( r- >right * SCREEN 

/ m_cxRes) / 

•(WORD •) (InBuf + 7) - (WORD) (r->bOt torn* SCREEN 

/ m_cyRes) ; 

if (ConroSendMsg(nID, InBuf ,9) ) TRACE (" %d message 
sent, <%d, %d,%d, %d) \n" . nID, r-> left, r-> top, r->right,r- 
> bottom) ; 

else ' TRACE l ( ■ ** %d 

message failed **\n n , nID) ; 
break; 

case. FBI DELIST FOLDER i // 4 
case PBID_ITEMFOCUSi // 102 
case FBID_TITLEBAR« // 401 
case FBIDJSROWBOXi // 403 
case PBID~HELPi // 4 04 

case PBID_HSCROLLi // 405 
case FBID^MENUt // 406 

case FBID_SYSMENUi // 40 9 

TRACE1C* Id recognized, but no message sent\n", 

nID) .- 

break; 
deEault i 

TRACE 1 ( ■ ** %d unrecognized by 
CFeedbacki i Enable () **\n", nID) ; 
break; 

J 

) 

void CPeedBacki iDiaable(UINT nID) 
{ 

una igned cha r I nBu £ 1 1 0 1 ,- 
RECT «r - NULL; 
InBuE [0) » FB ID_OFF; 

TRACE1 ("Disable called Eor FBID fftdi", nID) ; 
' switch (nID) { 

Case 305 i // TEXT SELECT 

ConunSendMsg (n ID, InBuf ,1) ; 
break ; 

case 306 i // PUSH VSCROLL 

i£ (£ pushvscroll) 
( 

E_pushvBcroll - 

ICommSendMsg In ID, InBuE. 1) ; 

i f ( £_pus'livscrul 1 ) TRACEO ( " FB I D_ PUSH VSCROLL 
•« FAILED **\n") ; 
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TRACB0 ( " FBID_PUSHVSCROLL 



elae 

disabled \n"); 

)elae( 

TRACEO ( " FBID PUSHVSCROLL not enabled\n" ) ; 

) 

break; 
case FBID WMSZi 

»if 0 

if <f_wmsz) { 

r - tg — rcWnd; 
BoundsCheck (r) ; 

* (WORD *)(InBu£ * 1) - (WORD) ( (r->left + 
2) * SCREEN / m_CxRes); 

* (WORD *) (InBuf + 3) - (WORD) ( (r->top * 
2) * SCREEN / m cyRes) ; 

"•(WORD *) (InBuf + 5) (WORD) ( (r->rlght - 
2) * SCREEN / m_CXRes) ; . 

• (WORD *) (InBuf ♦ 7) ■ (WORD) ( (r->bottom - 
2) * SCREEN / m_cyRes) ; £_wmsz - 

t (CommSendMsg(FBlD WMS2, InBuE, 9) ) ; 

ifTf_wmsz) TRACE Of PBID_WHSZ •• FAILED 

**\n") ; 

elae TRACE ( ■ FBIDJMSZ disabled 

(%d, %d, %d. %d) \n°, r->lef t , r->top,r->right, r->bottom) ; 
)elae( 

TRACE ( M FBID WMSZ not enabled\n») ; 

) 

ffendif 

break; 
Case FB I D_D RAGGING. 

if (f_dragging) { 
f ^dragging - 
I (ConunSendMsg ( FB ID_DRAGQ 1NO, InBuf ,1) ) , 

ifTf_dragglng) TRACEO ( " FB I D DRAGG I NG •• 

FAILED **\n") ; 

else TRACEO ( " PB I D DRAGG I NG 

disabled \n"); 

}else{ 

TRACEO (» FB I d_drago I no not enabled\n" ) ; 

) 

break; 
case PBIDJISCROLLlNGi 
if (£_hscrolling) { 
f_hscrolling ■ 
l (CoiranSendMsg(FBID HSCROLLING, InBuE, 1) ) ; 

ifTf_h9Crolling) TRACEO (« FB I D_H SCROLLING ** 

FAILED **\n") ; 

else TRACEO (" FB 1D_H SCROLLING 

disabled \n")i 
}else{ 

TRACEO ( " PBID_HSCROLLINO not enabled\n«)/ 

} 

break; 
case FBIDVSCROLLINOi 
if (f_v scrolling) { 
f_v scrolling - 
I (CommSendMsg(FBID VSCROLLING, InBuE, 1) ) ; 

ifTf_vscrolling) TRACEO (" FBID_VSCROLIiING *• 

FAILED **\n"); 

else TRACEO (« FBID_VSCROLLINO 

disabled \n«); 

)else( 

TRACEO (" FBID_VSCROLLING not enabled\n"); 

) 

break; 
case FBID_MENUITEHi 
if (f_menuitem) { 
f_raenuitem «« 
I CommSendMsg (FBI D^MBNUITEM, InBuf , 1) ;. 

if (£_menuitem) TRACE (« PB ID_MENUITEM ** 

FAILED **\n") ; 

else TRACE ( " FBID MENU ITEM 

diBabled\n") ; 

}else( 

TRACE ( " FBID MENU ITEM not en<abled\n n ) ; 
) ~ 
break; 
caae fbid__0FPi 

i£ (CommSendMBg(FBID_OPP, InBuE, 1) ) { 

f_vscr oiling • f_hscrolling -» f ^dragging 

FALSE; 

E wiTisz - FALSE; 
TRACEO (" FBID_OFP aent\n"); 
}else{ 

TRACSOf" PBID_OFP ** failed **\n"); 

} 

break; 
default i 

TRACE 1 ( ■ «• %d unrecognized by 
CFeedback n Disable **\n n , nID) ; 
break; 

I 

) 

void WINAPI TimeFunc(UINT wTimerlD, UINT mag, DWORD dwUaer, 

DWORD dwl, DWORD dw2) 

{ 

unsigned char InBuf [20]; 
WORD dx, dy; 

unsigned char newButtons; 

static unsigned char buttons - 0; 

DWORD Elags • 0; 

static WORD scrollDir - 0, acrollCount - 0; 
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UCHAR ocrollRate - Oxff; 
POINT cursorPoe; 

iC (CommGetMeg ( InBuC) ) ( // there's a men sage 

unsigned short type - * (unsigned ohort M(InBuf); // 
bytes 0 £ 1 are types 
switch (type) { 

caee('P'). // its a position message 
dx - '(WORD MdnOuf ♦ 2)/ 
dy ■ MWORD MUnBuf + 4); 
newButtons » InBuf[6); 

if ((newButtons * buttons) & OxX) { //left 
mouse button change 

if (newButtons & 0x01) flags |- 
MOUSEEVENTP_LEFTDOWN; 

else flags |« 

MOUSE BVENTP LEFTUP; 

) 

If ((newButtons A buttons) £ 0x2) { // right 

mouse button change 

if (newButtons & 0x02) flags | - 
M0USBEVBNTP_RIGHTDOWN; 

elae flags |» 

M0USEEVENTP RIGHTUP; 
} 

if ((newButtons * buttons) & 0x4) ( // 
middle mouse button change 

if (newButtons & 0x04) flags |- 
M0USEEVENTP_MI DDLBDOWN ; 

, else flags |» 

MOUSEEVENTP_N I DDLEUP ; 
) 

flaga |- (MOUSEEVENTF_ABSOLUTB | 
M0USEEVENTF_MOVB) ; 

tnouae_event (flags, dx. dy, 0, 0); 

buttons ■ newButtons; //store the last buttons 

// Do TouchCheck stuff 

H define _ResetTouchProtected ( ) 

InterlockedExchange ( 
t (CTouchChecki ip_mTouchProtected) , 0 ) 

Hdefine _SetTouchProtected ( ) 

InterlockedExchange ( 
& (CTouchChecki tp_mTouchProtected) , 1 ) 

_SetTouchProtected() ; 
if ( 

CTouchCheck i i IsReadyToTouch ( ) ) 

{ 

GetCursorPos ( 

GcCursorPos ) ; 

gjpTouch- 

>TryTouching ( cursorPos.x, curaorPoa.y ); 

> 

_ResetTouchProtected() ; 

break; 

caaeCAM i // an action message 

8i£ 0 

if (GetCursorPos (teursorPos) ) { 
CAccessible *pacc - 
CAcceasiblei (Create ( cursorPos) ; 

if (pace) pace -> DoOb j Def Act ion () ; 

) 

flendif 

break; 

casefS'lt // a scrolling message 

BiC 0 

scrollRate - * (UCHAR *)(InBuf 

+ 3), 

scrollDlr - MUCHAR *)(InBuf + 3); 
TRACE2 ("Scrolling Message. Rate. %d Din %d\n", 
(int)scrollRate, (int)scrollDlr) ; 
DcrollCountt* ; 

if (scrollRate <: 200 && scrollCount > 

scrollRate) { 

TRACEK -Scrolling Window t Rate. %d\n'\ 

scrollRate) 

ScrollThe Window (cursorPos, 0, scrollDir); 
scrollCount « 0; 

) 

ft end if 

break; 
} //end switch 

) 

) 

BOOL CPeedBack i iStartSerraMousePake (UllTT period) 



( 



TRACE ("CFeedBack: ;StartSerraMousePake\n" ) ; 



TIMECAPS tc; 

if (timeGetDevCapsUtc, sizeof (TIMECAPS) ) I- 
TIMBRR_NOERROR) return FALSE ; 

UINT wTimerRes - min(max(tc.wPeriodMin, 
1) , tc.wPeriodMax) ; 

timeBeg in Period (wTimerRes) ; 
if (period < wTimerRes) 
period » wTimerReB; 

timer ID - t i me Set Event (period, period, Time Func, 0 , 
TlME__PERIODIC) ; 
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) 



if (timeriD) return TRUE; 
return PALS B ; 



void CFeedBack i .StopSerraMouoePake (void) 



TRACE ("CPeedBack i . StopSerraMousePakeVn") j 
if (timeriD) timeKillBvent (timeriD) ; 



Vbutil.li 

// VBUTIL. C - Example DLL for Visual Basic applications. 

//«B VBUtil 

flinclude "vbutil.h" 

H INSTANCE dlllnst - NULL; 

// This function is the library entry point. It's 
technically 

// optional for 3 2 -bit programs , but you* 11 have more 
options later if you define it. 

BOOL WINAPI DllMain (H INSTANCE hlnstA, DWORD dwReason, LPVOID 

lpvReserved) 

{ 

switch (dwReason) { 
case DLL_PROCESS_ATTACHi 

// The DLL is being mapped into the 
process's address space 

// Do any additional initialization here 

dlllnst - hlnstA; 

break; 

case DLL_THREAD_ATTACH i 

// A thread is being created 

break; 

case DLL_THREAD_DETACH t 

// A thread is exiting cleanly 

break; 

case DLL_PROCESS_DETACIl i 

// The DLL is being unmapped from the 
process's address space 

//Do any additional cleanup here 
dlllnst - 0/ 

break; 

) 



return TRUE; 



) 

//®E VBUtil 

// 16-bit version for comparison 
ttif 0 

int PASCAL LibMain (H INSTANCE hlnstA, WORD wDataSeg, 

WORD cblleapSize, 

LPSTR lpCmdLine) 
{ 

if (cblleapSize J- 0) 

UnlockData(O) ; 
dlllnst - hlnstA; 

// Do any additional 16-bit server initialization 

here 

return dlllnst; 

) 

int FAR PASCAL WEP(int bSystemExit) 
{ 

// Do any additional 16-bit server cleanup here 
dlllnst o 0; 
return 1; 

} 

flendif 

//<3>B Errorllandler 

void Errorllandler (Long e) 

{ 

DWORD err -0; 
if (e >- 0) ' ( 

err - (DWORD) e; 
J else { 

err - HResultToErr (e) ; 

) 

SetLastError ( (DWORD) err) ; 

> 

//»E ErrorHandler 

DWORD HResultToErr (Long e) 
{ 

ASSERT (e < 0) ; 

switch (ej { 

case E_IHVALIDARG. 

return ERROR_ I NVAL I D_P ARAM ETER ; 
case E 0UTOFMEM0RY. 

return ERROH_NOT_ENOUGH_MBMORY ; 
case DISP B BAD I NDExT 
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return BRROR_INVALID_INDEX; 
case DISP_B_TYPEMlSMATCHi 

return ERROR__I NVAL I D_D ATATY PE ; 
case DISP_B_EXCBPTION» 

return ERROR_EXCEPTION_IN_SERVICE; 
case DlSP_B_BADVARTYPEt 

return ERROR_INVALID_DATATYPE; 
case D I 9P_E_ARRAY1 SLOCKED i 

return ERROR_LOCKED; 
case EJJNEXPECTEDi 

return ERROR_IWVALID_DATA; 
case DlSP_E_OVERPLOWi 

return ERROR_ARITHMETIC_OVERFLOW; 
case E ACCESSDEN 1 ED i 

return ERROR_ACCESS_DENIBD; 
case. B_POINTERi 

return BRROR_INVALID_ADDRESS; 
case BJlANDLEi 

return ERROR_lNVALID_HANDLB; 
case EABORTi 

return ERR0R_0PERATION_AB0RTED; 
case E_FAILt 

return ERROR GEN FAILURE; 

) 

return ERROR I NVAL I D_DATA / 



Vbutil.cpp 

// VBUTIL . C - Example DLL for Visual Basic applications. 



//9B VBUtil 

fiinclude "vbutil.h" . 

it INSTANCE (ill Inst - NULL; 

// This function is the library entry point, it's 
technically 

// optional for 32 -bit programs, but you'll have more 

options later 

//if you define it.. 

BOOL WINAPI DllMain (H INSTANCE hlnstA, DWORD dwReasOn, LPV01D 

lpvReserved) 

{ 

switch (dwReason) { 
case DLL_PROCESS_ATTACH i 

// The DLL is being mapped into the 
process's address space 

// Do any additional initialization here 

dlllnst = hlnstA; 

break; 

case DLL_THREAD_ATTACHi 

// A thread is being created 

break; 

Case DLL_THREAD_DETACH i 

// A thread is exiting cleanly 

break; 

case DLL_PROCBSS_DETACH t 

// The DLL is being unmapped from the 
process's address space 

// Do any additional cleanup here 
dlllnst - 0; 

break; 

} 

return TRUE; ' 

} 

//®E VBUtil 

// 16-bit version for comparison 
Hit 0 

int PASCAL LibMain (H INSTANCE hlnstA, WORD wDataSeg. 

WORD cbHeapSize, 

LPSTR lpCmdLine) 



( 



} 



if (cbHeapSize I ■ 0) 

UnlockData (0) ; 
dlllnst = hlnatA; 

// Do any additional 16-bit server init here 
return dlllnst; 



*int FAR PASCAL WBP(int bSystemExit) 



llendie 



// Do any additional 16-bit server cleanup here 
dlllnst - 0; 
return 1; 



//«B ErrorHandler 

void Brrorllandler (Lony e) 

{ 

DWORD err » 0; 
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if (e »- 0) { 

err - (DWORD) e"; 
) else { 

err - HResultToErr (e) ; 

) 

SetLaatError ( (DWORD) err) ; 

} 

/ / ®E ErrorHandler 

DWORD HResultToErr (Long e) 
{ 

ASSERT (e < 0) / 

switch (e) { 

case E_ I NV AL I D A R G i 

return ERROR_ I NVAL I D_ PARAMETER; 
case E_0UT0FMEMORY i 

re tu r n ERROR JJ0T_EH0UCH_M EMORY ; 
case DISP_E BADINDExT 

return BRROR_INVALID_INDEX, 
case DISP_E_TYPEMISMATCHi 

return E RROR_ I N VA L I D_DATATYPE ; 
case DISP_B_EXCEPTI0Ni 

return ERR0R_EXCEPTlON_IN_SERVICB; 
case DISP_E BADVARTYPEi 

return ERROR_INVALID_DATATYPE; 
case DIS P_S_ARRAY I SLOCKED i 

return ERROR_LOCKED; 
case E__UNEXPECTED t 

return ERROR_INVALID_DATA; 
case DISP_E OVERFLOW i 

return BRRORJ\RITHMBTIC_pVERFLOW; 

case e accessdenTed « 

return ERROR_ACCBSS_DENIEO; 
case E_POINTERt 

return ERROR_ I NVAL I D_ADDRB S 8 ; 
case E_HANDLEi 

return ERROR_ I NVAL I D^HANDLE ; 
case B_AB0RTi 

return error_OPERATI0N_ab0RTED/ 
case E_FAILi 

return BRROR_GEN_FAILURE; 

} 

return ERR0R_I NVAL ID_DATA ; 



OutData.h 

////////////////////////////////////////////////////////// 

// iFData.h - this header file contains all IForce related 
data and string definitions 



fiifndef 
fidefine 



_IPDATA_H_ 
IFDATA H 



////////////////////////////////////////////////////////// 
// Control Feedback Definitions 

////////////////////////////////////////////////////////// 

// currently defined in SerraRemote/ Feedback? t 
fidefine FBID_0FF 0 // Y 

« define FBID_0N 1 

////////////////////////////////////////////////////////// 
// Definitions for object related feedback 

/////////////////////////////////////////////////////////// 
H define FBIDLISTITEM 2 
fi define FBI OCTREE ITEM 3 
« define PBID_LISTFOLDER 4 
fidefine PB ID_TR EE FOLDER S 
« define FBIP_MENUITEM 6 
fidefine FBID_CHECKBTN B 
fi define FBID_RAD!OBTN 9 
fide fine FB I D_PUSH BTN 10 
fl define FB ID SEPARATOR 11 

/////////////////////////////////////////////////////////// 
// State related Feedback Definitions 

/////////////////////////////////////////////////////////// 
fide fine FB I D_ I TEMUNAVA 1 LABLE 100 
fide fine fbid_itemchecked < 
fi define FB I D_ I TEM FOCUS 
fide fine FB1D_ I TEM SELECT 
fide fine PB1D_ITEMC0LLAPSE 
fidefine PB I D_I TEM EXPAND 



// Y 



101 



104 



102 
103 



105 



fidefine FBID_BOTTOM 
fidefine FBID_BOTTOMLEFT 
fidefine FB ID_ BOTTOMRIGMT 
fidefine FBI DELEFT 
fidefine FBID_RIGHT 
fidefine FBIDJTOP 
fidefine PBIDTOPLEFT 
fidefine fbidjtopright 
fidefine FBID TITLE 



200 
201 



205 
206 
2D7 



208 



/////////////////////////////////////-////////////////////// 
// Definitions for event related feedback 

/////////////////////////////////////////////////////////// 
Hdefine FBIDJJRAGGINO 3 00 // Y 
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□ 
111 
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Hdefine PB1D WMSZ 
fldefine FBIDJISCROLLINO 
Hdef ine FB ID VSCROLLING 
Hdefine FBID~FOCUS 
fldefine pbid_whdminmax 
f| define ' fb I d~ wndch anq e 



301 
302 
303 
3 04 

306 



/////////////////////////////////////////////////////////// 
// Window elements 

/////////////////////////////////////////////////////////// 



Hdefine 


FB I D_ BORDER 


4 00 


Hdef ine 


fbidjtitlbbar 


401 


Hdefine 


FBID_CLOSB 


4 02 


«def ine 


FBID~GROWBOX 


403 


Hdefine 


FBIDJIELP 


4 04 


Hdefine 


FBID~HSCROLL 


4 05 


Hdefine 


FBID MENU 


4 06 


Hdefine 


FBID MAXBTN 


4 07 


Hdef ine. 


FB I D_M I NBTN 


408 


Hdefine 


FBID SYSMENU 


409 


fldefine 


FBID~VSCROLL 


410 



/////////////////////////////////////////////////////////// 

// Times 

/////////////////////////////////////////////////////////// 

typedef struct. 

{ 

int cOps / 

DWORD dwBgn; 
DWORD dwEnd; 
DWORD dwCum; 
} EVJTIME, *PBV_TIME; 

typedef struct 
{ 

int fDrag t 2; 
int fWmsz i l; 
int f Scroll » X; 

} FLAGS ; 

/////////////////////////////////////////////////////////// 
// Some integer and string ids 

/////////////////////////////////////////////////////////// 
fldefine SZ_RKCT ■ (%d, %d. %d. Id) • 

fldefine SZ^NUMDRAO " i%ld drags" 

Hdefine SZJiORZ "Horizontal 
scrollbar" 

Hdefine SZ_VBRT "Vertical scrollbar" 

Hdefine SZ~SCROLLING "ln\nPoei tld.Hin: %ld,Maxt 

%ld" 



Hdefine MAX_BUF 
Hdefine MIH_BUF 
Hdef ine SMALL 



2048 

126 

64 



/////////////////////////////////////////////////////////// 
// Event strings 

/////////////////////////////////////////////////////////// 

Hdef ine NUM_OP "%ld Operations" 

fldefine TIME_OP "Operation time. %s\n* 

fldefine TIME CUM "Cumulative Timei %a\n\n" 

Hdef ine TIME^STRING "llu Hr(s)»%lu Min(s)i%lu 

Sec(o) i %lu ins" 



fldefine OP_APP 
Hdef ine OPJ3RAG 
fldefine OP_SCR0LL 
Hdef ine OP WMSZ 



"\nApp Exited\n" 
u \nDrag operation\n° 
"\nScroll opera tion\n° 

"\nMove/aiie operation\n" 



/////////////////////////////////////////////////////////// 
// Event strings 

/////////////////////////////////////////////////////////// 
Hdef ine EVJJ0NE 0 
Hdefine BV LBTNDN 1 
Hdefine EV_LBTNUP 2 
Hdefine EV_MOUSEMOVE 3 
Hdefine EV menus el 4 
Hdefine EV_DRAGSEL 5 
Hdefine EV_DRAGGING 6 
Hdefine EV_DROP 7 
Hdefine EV_SCROLLING 8 
Hdefine EV~WMSZ 9 
Hdefine EV~F0CUS 



10 



/////////////////////////////////////////////////////////// 
// Object state otrings' 

/////////////////////////////////////////////////////////// 



Hdefine STATR__UNAVA I LAB LB 
Hdefine STAT E~S ELECTED 

"Selected;" 
Hdefine STATB_FOCUSED 
Hdefine STAT E_ PRESSED 
Hdefine STATEJTHECKGD 
Hdefine STATB_MIXED 
Hdefine STATE~READONLY 
only ; • 

fldefine STAT B_HOTTRAC RED 
Hdefine STATE DEFAULT 



"Unavailable; " 



"Focused; ■ 
•Preoeed; " 
"Checked; " 
"Mixed;" 
"Read 

"Hot tracked;" 

•Default," 



Hdefine STATE_EX PAIJDBD 
"Expanded;" 

fldefine STATE_COLLAPSED 
"Collapsed; " 

Hdefine STATB_BUSY 

Hdefine state_floatino 
"Floating; " 

Hdefine STATE_MARQUEED 

text; " . . 

Hdefine STATE^AN I MATED 

"Animated; " 
Hdefine STATE_ INVISIBLE 
Hdefine STATE_OF FSCREEN 
screen; 11 

Hdefine STATE_S I ZABLE 
Hdefine STATE MOVABLE 
Hdefine state~selfvoicing 

Hdefine STATERS ELECTABLE 
Hdefine STATE_FOCUSABLE 

"Focusable/ * 
Hdefine STATE_LINKED 
Hdefine STATB_TRAVBRSED 

"Tracersed;" 
Hdefine STATE_MULTISEL 
sel; • 

Hdefine STATB_EXTSEL 
Hdefine STATB_AL_LO 
Hdefine STATE AL MB 
Hdefine STATE~AL~HI 

Hendif 



"Busy; " 
"Scroll 



"Hidden;" 
"Off- 



"Sisable;" 

"Movable;" 
"Self voice;" 
"Selectable; ■ 



"Linked/" 



"Multi 

"Ext Belt" 
"Low;" 
"Medium; ■ 
"Hi;" 



StdAfx.h 

// stdafx.h r include file for standard system Include 
files, 

// or project specific include files that are used 

frequently, but are changed infrequently 

HiE 

I defined < AFX_STDAFX_H B9986C44_3FEB_11D1_A8 68_00600B3A2742 

_INCLUDED_J 

Hdefine 

AFX_STDAFX_H E9986C44 J3FED_11D1_A868_0 06008 3A2742 INCLUDED 



A if _MSC_VER >« 1000 
Hpragina once 

Hendif // MSC VER >- 1000 



Hdefine STRICT 



fi include <afxwin.h> 
Hinclude <afxdisp.h> 



Hdefine _WIN32_WINNT 0x0400 
Hdefine ~ATL APARTMENTJTHREADED 



Hinclude <atlbase.h> 

//You may derive a class from CComModule and use it if you 
want to override ■ 

//something, but do not change the name of _Module 
extern CComModule _Module,- 
Hinclude <atlcom.h> 
Hinclude <atlctl.h> 

// { { A FX_ I NS ERT_LOC AT ION} } 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. 



Hendif // 

1 defined (AFX STDAFX_H_ 
INCLUDED) 



E9986C44 3 FEB 11D1 A868 0060083A2742 



StdAfx.cpp 

// stdafx.cpp i source file that includes just the standard 
includes 

// stdafx.pch will be the pre-compiled header 
// atdafx.obj will contain the pre-compiled type 
information 



Hinclude "stdafx.h" 

8 if def _ATL_STAT IC_REG I STRY 

Hinclude <statreg.K> 

Hinclude <statreg.cpp> 
flendif 

Hinclude <atlimpl . cpp> 

Hinclude <atlctl.cpp> 

Hinclude <atlwin.cpp> 
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APPENDIX B 

Source code implementing different feels of Fig. 12 using 
force-only ActiveX control. 

FeelControl.odl 

// FeelControl.odl t type library source for ActiveX Control 
project. 

// This file will be processed by the Make Type Library 
(mktyplib) tool to 

// produce the type library (FeelControl . tlb) that will 
become a resource in FeelControl .ocx. 

H include <olectl.h> - 
((include <idispids.h> 

t uuid(78ACP764-5CCl-llDl-A868-0Oe0083A2742) , version ( 1 . 0) , 
helpfilet" FeelControl. hip- J , 

helpstring ("FeelControl ActiveX Control module"), 
control ] 
library FBELCONTROLLib 

. import lib (8TDOLB_TLB) / 
import lib (STDTYPEJTLB) / 

// Primary dispatch interface for 
CFeelControlCtrl 

[ Uuld(78ACP765-SCCl-llDl-AB68-0060083A2742) . 
helpstring ("Dispatch interface for FeelControl 
Control?), hidden J 

dispinterf ace _DFeelControl 
{ 

properties ■ 

// NOTE .- ClaBsWizard will maintain 
property information here. 

// Use extreme caution when 

editing this section. 

//{{APX^ODLPROP (CFeelControlCtrl) 

(idU))~BSTR Effectl; 

[ld(2)J BSTR Effect2; 

(id(3H BSTR Effect3; 

[id(4)J BSTR Bffect4; 

[id(5)I BSTR EffectS; 

Ud(6) } BSTR Bf fectfi; 

//})AFX_ODL_PROP 

methods t 

// NOTE - ClassWiaard will maintain 

method information here. 

// Use extreme caution when 

editing this section. 

// { { A FX_ODL_METIIOD (CFeelCont rolCtr 1 ) 
~" [id(7)] long DoEf feet (short 

effectNutn) / 

(id(8)J long StopEf feet (short 
ef fectNum) / - . ' 

lid(9)J void StopAllO; 

tid(10)J long SetEf fect(ehort 
ef fectNum, BSTR effect Pa rams) ; 

tidUDI long 

DoEnclosureEf feet (Bhort effectNum, long left, long top. long 
right, long bottom); 

(id (12)] long ApplyForce (long Xdir, 

long Ydir, long Mag ) 

[id (13)) long StopForceO ; 
//}}AFX ODL METHOD 

b 

// Event dispatch interface for CFeelControlCtrl 
I uuid(78ACP766-5CCl-HDl-A868-006OO83A2742) , 
helpstring ( "Event " interface for FeelControl 

Control") J 

dispinterf ace _DFeelControlEvents 
{ 

properties i 

// Event interface has no properties 
methods t 

// NOTE - ClaasWizard will maintain event 
information here. 

// Use extreme caution when editing this 

section. 

// { { AFX_ODL_E VENT (CFeelCont rolCt r 1 ) 
/ / j } AFX ODli EVENT 
h ~ ~ 

// Class information for CFeelControlCtrl 

I uuid(5uFDD466-5B37-llDl-A868~0060083A2742) , 
. helpstring ( " FeelControl Control"), control ) 
coclass FeelControl 
{ 
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{defaultl dispinterf ace _DFeelcontrol/ 
{default, eourcej dispinterf ace 

DFeelControlEvents; 
); 

//{(AFX APPEND ODL}} 
//} }AFX_APPEND~ODL) ) 



FeelControl. def 

,• FeelControl. def i Declares the module parameters. 

LIBRARY ■ FEELCONTROL . OCX " 

EXPORTS 

DllCanUnloadNow ®i PRIVATE 
DllGetClassObject ©2 PRIVATE 
DllRegisterServer 93 PRIVATE 
DllUnregisterServer 04 PRIVATE 



FeelControl.h 

«if 

! defined (AFX^PEELCONTROLJI 78ACF76C_5CC1 11D1_A868_0060083A 

2742 INCLUDED^) 

((define 

AFX_FBELCOHTROL_H 78ACP76C_5CCl_llDl_A868J)O60083A2742 INC 

LUDED_ 

((if _MSC_VER >» 1000 
((pragma once 

Sendif // _MSC_VER >» 1000 

// FeelControl.h i main header file for FEELCONTROL . DLL 

(lif 1 defined ( AFXCTLJI ) 

((error include 'afxctl.h' before including this 

file 
(fendif 

((include " resource .h" // main sytnbols 

/////////////////////////////////////////////////////////// 
// CFeelControlApp i See FeelControl . epp for implementation. 

class CFeelControlApp $ public COleControlModule 
{ 

public i 

BOOL InitlnBtanceO ; 
int Exi t Instance ( ) ; 

i; 

extern const GUID CDECL _tlid; " 
extern const • WORD _wVerMajor? 
extern const WORD _wVerMinor; 

//{ {AFX_INSERT_LOCATION) } 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. 

Kendif // 

ldefined(APX>EBLCONTROL_H 7 8ACP76C_5CCl_liDa_A868_0O6O0B3A 

2742 INCLUDED) 



FeelControl. epp 

// FeelControl . epp i Implementation of CFeelControlApp and 
DLL registration. 

((include "stdafx.h" 
{(include "FeelControl.h" 
flifdef _DEBUO 
((define new DEBUG NEW 
ffundef THIS_FILE 

otatic char THIS_FIL,EIJ - FILE ; 

flendiE 

CFeelControlApp NEAR theApp; 

const GUID CDECL BASED_CODB _tlid - 

{ 0x78acf764, OxSccl, Oxlldl, { OxaB, 
0x68, 0, 0x60, 0x8, 0x3a, 0x27, 0x42 } }; 
const WORD _wVerMajor - 1; 
const WORD _wVe minor « 0; 

/////////////////////////////////////////////////////////// 
// CFeelControlApp i > Init instance - DLL initialization 

BOOL CFeelControlApp i i Init Instance ( ) 
{ 

BOOL blnit - COleControlModule n InitlnstanceO ; 



-66 



□ 



I* 



ill 
1U 



i£ (blnit) 

(• 

// TODOi Add your own module 
initialization code here. 
) 

return blnit ; 

) 

///////■//////////////////////////////////////////////////// 
// CFeelControlApp i .Exit Instance - DLL termination 

int CFeelControlApp. • Exit Instance ( ) 



// TODOi Add your own module termination code 
return COleControlModulei i Exit Instance () ; 



( 

here. 
) . 

/////////////////////////////////////////////////////////// 
// DllRegisterServer - Adda entries to the system registry 

STDAPI DllRegisterServer (void) 
{ 

AFX_MANAGB_8TATB (_af xModuleAddrThis) , 

if ( I AfxOleRegis terTypeLlb (AfxGet I nstanceHandle ( ) , 

_tlid) > 

return 

Result FromScode (SELFREG_E — TYPELIB) ; 

if ( 1 COleObjectFactoryEx t lUpdateRegiotryAll (TRUE) ) 
return ResultProtnScode (SBLFREG E CLASS) ; 
return NOERROR; 

) 

/////////////////////////////////////////////////////////// 
// DllUnregiaterServer - Removes entries from the system 
registry 

stdapi Dllunregi a ter Server (void) 
{ 

AFX_MANAGE_STATE ( _a fxModu 1 eAdd rTh i s ) ; 

if ( I AfxOleUnregisterTypeLib (_t lid, _wVerMajor, 
_wVecMinor) ) 

return 

ReBU It FromScode (SELFREG_E_TYPELIB) / 
if 

( I COleObjectFactoryEx i lUpdateRegiotryAll (FALSE) ) 

return Result FromScode (SELFREG B_CLASS) ; 
return NOERROR 

) 



FeelForces.h 



* PeelControl 

* (c) 1997 Immersion Corporation 
* 

* FILE 

* FeelForces.h 

* DESCRIPTION 

* Provide methods for doing force- feedback with the 
PocceClasaea 



ftifndef 
Hdefine 



FEEL FORCE S_H 

_PEELFORCES 11 



BOOL FeelSetup( 1! INSTANCE hlnst, HWND hWnd ) ; 
BOOL FeelCleanup( void ); 

BOOL FeelBeginEf feet ( shore effectNum J.- 
BOOL FeelEndEf feet ( short effectNum ); 
void FeelEndAllEffects( void ); 

long FeelBeginForce { long Xdir, long Ydir, long Mag ); 
long FeelEndForce ( void )/ 

long FeelEncloeureEffect (short effectNum, long left, long 
top. long right, long bottom)/ 

(lend if FEELFORCES II 



FeelForces.cpp 



/* 



* Fee l Control 

» 1c) 1997-1998 Immersion Corporation 



• PILE 
* DESCRIPTION 



Peel Forces .cpp 
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* Provide methods for doing force -feedback with the 

ForceClasses, giving the PeelControl some guts... 



^include "Btdafx.h" 
tfinclude "FeelPorces.h" 
It include "Force Feel itMouse .h" 
H include "ForceEffect .h" 
II include « Porce Periodic ,h" 
Winclude " ForceDamper .h" 
8 include "ForceEllipse.h" 
8 include "PorceCondition.h" 
if include "ForceConstant .h" 
ft include ■ PorceTexture .h" 
If include "ForceEnclosure .h" 
If include "ForceSpring .h" 
fl include <stdio.h> , 



// GLOBAL VARIABLES 
CForceFeelitMouBe* 
CPorceConstant* 
CPorceEf f ect * 
CPorceEf f ect* 
CForceEf feet * 
CPorceEf feet* 
CForceEf feet * 
CForceEff ect* 
CForceEffect* 
CPorceEf feet* 
CForceEffect* 
CForceEffect* 
CForceEffect* 
FORCE_ENV ELOPE 
FORCE_ENVELOPE 
FORCE^ENVELOPS 
FORCE ENVELOPE 



gMouse 
gForce . 
gBffectl - 
gEffect2 - 
gBffect3 » 
gBffect4 - 
gBffectS - 
gBffecte - 
gBffect7 - 
gEffectS - 
gBffect9 « 
gEffectll - 
gBngineEnc 
f Envelope 1/ 
f Envelope? ; 
f Envelopes ; 
f Bnvelope4 / 



- NULL; 

- NULL/ 

- NULL; 

- NULL; 

- NULL; 

- NULL; 

- NULL; 
NULL; 
NULL; 
NULL; 
NULL; 



NULL; 



- NULL; 



/* 



Global s for our parama 

•/ 

// Laser 

DWORD LDIRX » 1, LDIRY - 1, LDUR 

LPBR » 158. LOFF = 0, LPHA - 0; 

DWORD LDIRX 2 - -1, LDIRY2 - 1, LDUR2 - 1000 

LOFF2 - 0, LP11A2 » 0; 



1000. LMAG 



10000, 



13, 



LMAG 2 « 6744. 



LPER2 « 
// ICE 

DWORD IVIS - -4000, ISAT - 8000, IVEL - 10; 
// METEOR 

DWORD M STIFF -4 000, MWW » 20, MSAT - 8000; 
// DENIM TEXTURE 

DWORD DPOSK - 8 000, DNEGK - 8 000, DPOSS « 9, DNEGS » 9, 
DDBAD - 3; 
// DENIM GRID 

DWORD DGPOSK-3000, DGNEGK-3 000 , DGPOSS-3000, DGNEGS-3000. 
DGDEAD-14; 
// ENGINE 

DWORD EDIRX - 1, EDIRY - 0, EDUR-2000, EMAG-5968, 
EPER-295, EOFF-0. EPHA-0; 

DWORD EDIRX2 - 0, EDIRY 2 - 1, EDUR2-3500, EMAG2-1Q0OO, 
BPER2-100, EOFF2-0. EPHA2-00; 
// ENGINE ENCLOSURE 
DWORD EST I FF -980O, EWW - 28, 
// RAQUET STRING GRID 
DWORD SPOSKo3000, SNEGK-3000, 
SDEAD-14; 
// RAQUET ELLIPSE 
DWORD RSTIFF «• 6000, RWW - 10, 
6000, RWW « 20, RSAT - 8000 
// ENGINE ENVELOPE 

DWORD EEAL - 1O000, BEAT « 390697, EEPL .1, BEPT-967441; 
DWORD EEAL2 - 0, EEAT2 - 2572093, EEPL2-100OO. EEPT2-830232; 
// LASER ENVELOPE 

DWORD LEAL - 3 953, LEAT - 144166, LEFL-3B7, 
LEFT«641860; 

DWORD LEAL2 * 10000, LEAT2 - 28372 0, LEFL2-0, LEFT2-0; 



BOOL FeelSetup( H INSTANCE hlnBt, HWND hWnd ) 



ESAT • 9800, // 8000,20,8000 
SPOSS-300O, SNEGS-3000. 



RSAT - 8000; // RSTIPF . 



i 
I* 



BOOL success; 

// Try to get parameters from effects.dat 



FILE *fp «' f open (" feelcontrol.dat M , "r") ; 
if (fp) { 

// Laser 

fscanf (fp, "Id %d %d Id %d Id %d- , 

&LDIRX, tLDIRY, &LDUR, &LMAG, &LPER, tLOFP. &LPIIA ) ; 

fscanf (fp,"%d Id %d %d %d Id %d*. 
&LDIRX2, &LDIRY2, t LDUR 2 , &LMAG2 , &LPER2 , &LOPP2, 6LPHA2 ); 

// ICE 

fscanf (fp,*ld %d ld M , 6IVIS, & ISAT, 

tlVEL ) ; 

// METEOR 

fscanf (fp,"%d %d Id", &MSTIFP. fcMWW, 

&MSAT ) ; 

// DENIM 

fscanf (fp, "%d %d %d %d Id", tDPOSK, 
& DNEGK, &DPOSS, &DNEGS, &.DDEAD ) ; 

// EHQINE 

fscan£(fp,"ld %d Id %d Id Id Id", 

& EDIRX, &EDIRY, &EDUR, &EMAG, &BPER, &EOFP, &EPHA ); 
// RAQUET STRING GRID 
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tscanf (fp. "%d %d %d %d %d" , &SPOSK, 
&SHEGK, &9POSS. tSNEGS, &SDEAD )/ 

// RAQUET ELLIPSE 

£ocan£(fp, "%d %d \d» , &RSTIFF, £RWW, 

fcRSAT ) ; 

// ENGINE 2 . 

tacanf Up, "td %d %d %d %d %d %d» , 
fcEDIRX2, 6EDIRY2. &BDUR2 , &EMAG2 , &EPER2 , &EOPF2 , 6BPHA2 ); 
// ENGINE ENVELOPE 

f scant (fp, "%d %d %d %d", fcEEAL, GEEAT, 



- &BEPL, 
&EEFL2 , 

6LEFL, 
&LEPL2 , 



&BBFT ) , 
&EBFT2 1/ 

&LEFT J ; 
&LEFT2 ) ; 



f scant (fp, »%d %d %d %d- , 6EEAL2, &EEAT2 , 
// LASER ENVELOPE 

fscanf (fp, "\d %d %d %d", &LEAL, &LEAT, 

facanf (fp, "%d %d *d %d", &LEAL2, I.LEAT2, 

// Close it... 
f close ( fp) ; 



// Set up the Mouse 
gMouse - new CForcePeeli tMouse ( ) / 
iC ( I , gMouse ) goto PS_Err; 
success » gHouBe- >lnitialire ( hlriBt, 
if ( I euccesa ) goto FSjsrr; 



hWnd ) ; 



// 
// 
// 
// 
// 
// 
// 
// 
// 



// Set up the Force 
gPorce » new CForceConstant ( } ; 
if ( l gForce ) goto FS_Erf; 
success « gForce- > Initialize ( 
gMouse, 

FORCE_CONSTANT_DE FAULTED I RECTI ON , 

INFINITE, 

0 

if ( I success ) goto FS_Err,- 



// Set envelopes... 

// Envelope 1 

f Envelopel .dwSize 

Oizeof (FORCE_ENVELOPE) / 

f Envelopel .dwAttackLevel 
f Envelopel .dwAttackTime 
f Envelopel .dwFadeLevel 
f Envelopel .dwFadeTime 
// Envelope 2 
f Envelope 2 .dwSize 

Bizeof (FORCB_KNVELOPE) ; 

f Envelopes .dwAttackLevel 
f Envelope 2 .dwAttackTime 
f Envelopes .dwFadeLevel 
f Envelope 2 .dwFadeTime 
// Envelope 3 
f Envelopes .dwSize 

Siieof ( FORCE_BNVBLOPS) ; 

f Bnvelope3 .dwAttackLevel 
f Envelope 3 .dwAttackTime 
f Envelope 3 .dwFadeLevel 
f Envelope! .dwFadeTime 
// Envelope 4 
f Envelope4 .dwSize 

Bizeof ( FORCE ENVELOPB) , 

f Envelope 4 .dwAttackLevel 
£Bnvelope4 .dwAttackTime 
f Envelope4 .dwFadeLevel 
fEnvelope4 .dwFadeTime 



EEAL; 
EE AT; 
, EEPL; 
EEFT/ 



EEAL 2 ; 
EEAT2 ; 
EEFL2; 
EEFT2; 



LEAL; 
LEAT; 
LEFL; 
LEFT; 



LEAL2 ; 
LEAT2 ; 
LEFL2; 
LEFT2; 



// Create effect 1 - LASER (PERIODIC SINE (l,0) 750 3023 10 
0 0) 

//Laser Effect fll 

gEffectl » new CForcePeriodic (GUID_Force_Square) ; 
if ( t gEffectl ) goto'FS_Err ; 

success • ( (CForcePeriodic*)gE£ fectl) - initialize ( 
gMouse, 
LMAG, 

// - FORCE_P E R I OD I C_DE FAU LT__MAGN I TU DE 
LPBR. 

// - FORCE_PERIODIC_DEFAULT_PERIOD 
LDUR , 

// - F0RCE_PERIODIC_DEPAULT_DURATION 

LDIRX, 
// X Direction 

LDIRY, 

// Y Direction 
LOPF. 

// - FORCE PERlODIC_DEPAULT_OFFSET 
LPHA. 

// « F0RCE_PERIODIC_DEPAULT_PHASE 
&fEnvelope3 

) ; 

if ( \ success ) goto FS_Err ; 
// Laser effect 82 

gEffecte « hew CForcePeriodic (GUID_Force_Sine) 
if ( I gEffecte ) goto FS_Err; 

success - ( (CForcePeriodic* JgEffectB ) -^Initialize ( 
gMouse, , 
LMAG2, 

// •> FORCE PERIODIC_DEPAULT MAGNITUDE 
LPER2 , 

// - PORCE_PERIODIC_DEFAULT^PBRI0D 



LDUR2 , 

// - PORCE_PERIODIC_DEFAULT_0URATION 
LDIRX2 , 

// X Direction 

LD1RY2, 
// Y Direction 

LOFP2. » 
// - FORCE_PERIODIC__DBFAULT_OPPSET 

LPHA2 , " 
// - FORCE_PERIODIC_DBFAULT_PHASE 

&£Envelope4 
) ; • 
i£ ( 1 succeaa ) goto FS_Err/ 

// Create effect 2 » ice (DAMPER -1000 8000 0 -1) 
gE£fect2 » new CPorceDamper ( ) / 
if ( l gE£fect2 ) goto FS_Err ; 

succeaa ■» ( (CForceDamper*) gB££ect2) - ^Initialize ( 
gMouBe, 
IVIS, // » 

FORCE_DAMPER_DEFAULT_VISCOSITY 

TSAT, // - 
FORCE_DAM PER_DEFAULT_SATURATION 

TVEL, // - 
FORCB_DAMPER_DEFAULT_MIN_VBLOCITY 

FORCE EPF ECT_ AX I S BOTH 

)( 

if (I success ) goto FS_Err; 

// Create effect 4 - METEOR (ELLIPSE -1 -1 2000 -1 -1 -1 -1 
-1 8) 

gE£fect4 «• new CForceBlllpse; 
if ( l gEffect4 ) goto PS_Err; 

Bucceas « ( (CForceEllipseMgBf fect4 ) - initialize ( 
gMouse, 

FORCE_BLLI PSE_DEFAULT_WIDTH . 
PORCB~ELL I PSEJ3E FAULT_HE I GHT , 
MSTIFF, // - 
FORCE ELLIPSE DEPAULT_STIPFNESS 
MWW. 
MS AT, 

FEELIT_FSTI FFOUTBOaNDANYHALL, 
/ / FORCEELLI PS E_DEFADLT_ST I FFNBSS_MASK . 

FORCB_£LL I PSE_DBFAULT_CL I PP I NG_MASK , 
FORCE_BLLI PSB_DSFAULT_CENTER POINT, 
NULL 

> f . 

if (I success ) goto FS_Err; 

// Create effect 5 - DENIM (CONDITION TEXTURE ???? ) 
gBf fect5 - new CForceTexture ( ) / 
if ( I gEffectS ) goto FS_Err; 

success » ( (CForceTexture* )gE££ectS) - >InitTexture ( 
gMouse, 
DPOSK, 

// lPosBumpMag « FORCE_TEXTUR B_DE P AULT_MAGN I TUDE , 
DPOSS , 

// dwPoBBumpWidth - FORCE_TEXTURB_DEFAULT_WIDTH, 
DDE AD, 

// dwPosBumpSpacing » 
FORCE_TEXTURE_DEFAULT_S PAC I NG . 
DNEGK, 

// INegBumpMag - F0RCE_TEXTURE_DEFAULT_MAaNITUD8, 
DNEGS, 

// dwNegBumpWidth - FORCE_TEXTURE_DEFAULT_WIDTH, 
□DEAD , 

// dwNegBumpSpacing-FORCB_TEXTURE_DEFAULT SPACING. 
FORCE_EFPECT_AXTS_JC // dwfAxia - 

FORCE_EFFECT_AXIS BOTH, 

// pntOff set - FORCE jrEXTUHB_DEPAUL,T_OFFSBT_POINT, 
// lDirectionX » F0RCE__EFFECT_DEPAULT_DIRECTION_X, 
// lDirectionY o FORCE_EFFECT_DEFAULT_DIRECTION_Y 

);. 

if ( J success ) goto PSJBrr/ 



// Create effect 11 
gEf fectll 



DENIM (GRID) 

new CForceCondition( GUID_Force Grid 



if ( ! gEf fectll ) goto FS_Err ; 
success - ( (CForceCondition* ) gEf fectll) - 
>InitCondition( 

gMouse. 

DGPOSK, //PosK 
DGNEGK, //NegK 
DGPOSS. //PooSat 
DGHEGS, //NegSat 

DGDEAD, //Deadband - grid spacing in 

pixels 

FORCE_EFFECT_AX I S_X 
/ / FORCE_EFFECT_AXIS_BOTH 

/ / FO R CB_COND I T 1 0N_DE PAULT_C ENTER_ PO I NT 

if ( ! auccess ) goto FS_Err; 

// Create effect 6 » MOTOR (PERIODIC SQUARE { 1, 1} 10000 
6500 20 0 180) 

gEEfectS - new CForcePeriodic (CUID_ForcejSquare) ; 

if ( I gBf feet 6 ) goto FS_Err; 

success - ( (CPorcePeriodic*)gB£f ect6) -^Initialize ( 
gMouse, 
EMAG, 

// - FORCE PERIODIC_DBFAULT MAGNITUDE 
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eper; 

// » force periodic_default_pbriod 

EDUR, * 1 

// • FORCE_PERIODIC_DEPAULT_DURATIOM 

EDIRX, 
// X Direction 

EDIRY, 

// Y Direction 
EOFP, 

// - FORCE PER rODIC_DEPAULT_pPFSET 
EPHA. 

// o F0RCE_PER10DIC_DBFAULT_PHASE 
&f Envelope 1 

) ; 

if { I aucceBG ) goto PS_Err; 

// Create effect 9 « MOTOR (PERIODIC SQUARE (l, 1} 10000 
6500 20 0 1B0) 

gSffect9 = new CFo rce Pe r iodic (GUI D_Porce_Sine) ; 

if ( I gE££ect9 ) goto FS_Err; 

oucccdo - ( (CPorcePeriodic*)gB££ec;t9) -initialize ( 
cjHouae, 
EM AG 2 , 

// m FORCB_PERIODIC_DEPAULT_MAGNITUDE 
EPER3 , 

// «. FORCE — PER I ODI C__DEFAULT_PER IOD 
EDUR 2, 

// - FORCE_ P ER I OD I C_D EFAULT_D URAT I ON 

ED1RX2 , 
// X Direction 

EDIRY2, 
// Y Direction 

EOFF2, 

// - FORCE_PERIODIC > .DEFAULT_OFFSET 
EP1IA3, 

// m FORCE_PERIODIC_DEPAULT_PHASE 

t (Envelope 2 

); 

if ( J success ) goto PS_Etr; 

// Create effect 7 - RACQUET_GRID (condition grid) 

gEf feet? » new CForceCondition( GUID_Force_Grid ) t 
if ( I gEffect7 ) goto FS_Err; 



success 
>InitCondition( 



( (CPorceCbndition*)gBC£ect7) - 



gHouse 
SPOSK, 
SNEGK, 
SPOSS, 
SNEGS, 



if 



//PoeK 
//NegK 
//PoeSat 
//Negsat 

SDEAD //Deadband -grid spacing in pixels 
/ / FO RC B_EF FECT_AX I SBOTH , 
/ / FORCE__COND I T10N_DE FAULT_CENTER_PO I MT 

( I success ) goto PS_Err; 



-1 -1 



// Create effect 3 - RACQUET (ELLIPSE -1 -1 2000 - 
-1 -1 8) 

// Hake 3 after. 7 because 3 ie dependent on 7 
gE£fect3 - new CForceEllipse; 
if ( I gBffect3 ) goto FS_Err; 

success - ( ICForceBllipseMgEf £ect3) -> Initialize ( 
gMouse, 

PORCE_ELL I PSB_DEFAULT_W I DTH , 
FORCB~ELLIPSE_DEFAULT_HEIGHT, 
RSTIFP, // - 
FORCE ELLIPSE DEFAULT STIFFNESS 
RWW. 
RSAT, 

FEBLIT_FSTI PP_OUTBOUNDANYWALL # 

//peelit f stiff an yw all , 

//force_ellipsb_default_stiffness_mask, 

Force3ellipsb_defaultclipping_mask, 
forcb2ellipse_default_center_point, 

gEf fee t7 

)/ 

if ( I success ) goto FS_Err; 

// Engine Enclosure 
gEngineEnc « new CForceEnclosure; 
i£ ( I gEngineEnc ) goto FS_Err ; 
success - ( (CForceEnclOBure*) gEngineEnc) - 
>Initialize( 

gMouse, 

FORCE ENCLOSURB_DEFAULT_W I DTH . 
force" ENCLOSURE_DEFAULT_M bight, 
EST1PF, // - 
FORCBJ3LLI PSE_DEFAULT_STI FFNBSS 
EST IFF, 
EHW, 
EWW. 
' ESAT, 
ESAT, 

FEELIT_PSTI FF_OUTBOUNDANYWALL, 
/ / F0RCE_E LL I PS E_D E FAU LT~ST I F FN ESSJ4A S K , 

FORCE ENCL0SURB_DSPAULT_CL1 PPING_MASK, 

force~enclosure_default_cbntbr_po I NT, 

NULL 



if ( 



oucceBB ) goto FS_Err ; 



// We're okay! 
return TRUE; 
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let's cleanup and 



PS_Ern 

// There were some problems . 
declare ourselves deadi 
FeelCleanupO / 
return FALSE; 

) 

BOOL FeelCleanup( void ) 
( 

if ( gEngineEnc) { gEngineEnc- >3top ( ) /delete 
gEngineEnc; gEngineBnc-NULL; } 



gForce; 



if ( gForce ) 

gForce 
if ( gEffecti ) 
gEffectl; gEffecti « NULL; 

if ( gEffect2 ) 
gEffect2; gEffeCt2 - NULL; 

if ( gEffect3 ) 
gE£Eect3; gEffect3 « NULL; 

if ( gE£fect4 ) 
gEffect4; gEffect4 - NULL; 

if ( gEffectS ) 
gEf£ect5/ gE£fectS - NULL; 

if ( gEffectS ) 
gEffect6; gEffectS - NULL; 

if ( gE£fect7 ) 
gE£fect7; gE£fect7 « NULL; 

if ( gEffectS ) 
gEffectB; gEffectS - NULL; 

if ( gEffect9 ) 
gE£fect9; gE££ect9 - NULL; 

if ( gEffectll) 
gEffeCtll; gEffectll 
if ( gMouse ) 

delete gMouse; 

NULL; } 

return TRUE; 

) 

BOOL FeelBeginEf feet ( short effectNutn ) 
{ 



gForce->Stop(); delete 

NULL; ) 

gEf fectl->Stop() ; delete 

gEf fect2->Stop() ; delete 

gEf fect3 ->Stop() ; delete 

gEf fect4->Stop<) ; delete 

gEffect5->Stop() , delete 

gEf fect6->Stop<) ; delete 

gEf feet 7- >S top () ; delete 

gEf fectS->Stop() ; delete 

gE££ect9->Stop() ; delete 

gEf fectll->Stop() ; delete 
NULL/ } 

gMouse 



switch ( effectNum ) 
{ 



case Hi 



if ( gEffecti ) 

return gEf f ectl ->Start () ; 

break; 

i£ ( gEffect2 ) 

return gEf fect2 ->Start ( ) ; 
break; - 

if ( gEffectS ) 

return gEffectB ->Start () / 

break; 

i£ ( gEffect* ) 

return gEff ect4 ->start ( ) / 

break; 

i£ ( gEffectS ) 

return gEff ect5 ->Start ( ) / 

break/ 

if ( gEffectS ) 

return gEf f ect6 ->Start ( ) ; 

break; 

if ( gEffect7 ) 

return gEf fect7 ->start ( ) ; 

break; 

if ( gEffectB ) 

return gEffectS - >Start () ; 

break; 

if ( gECfect9 ) 

return gEf f ect9 - >5tart ( ) ; 

break; 

if ( gEffectll ) 

return gEffectll- >Start () ; 

break; 
break; 



return FALSE; 



BOOL FeelEndEf feet ( short effectNum ) 
{ 



switch ( effectNum ) 
( 

case It 



i£ i gEffecti ) 

return gEf f ectl ->Stop () / 

break; 

if ( gBffect2 ) 

return gEff ect2 ->Stop ( ) ; 
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break ; 

if ( gE££ect3 ) 

return gEf f ect3 • >3top ( ) , 

break; 

if ( gEffect4 > 

return gEf £ect4->StopU ; 

break; 

i£ ( gEffectS ) 

return gEf Eect5->StopU ; 

break; 

if { gEffecte ) 

return gE£fect6->Stop() ; 

break/ 

if { gE££ect7 ) 

return gE££ect7- >Stop () ; 

break; 

if ( gEffecte ) 

return gEf fectB->Stop { ) / 

break; 

if ( gE£fect9 ) 

return gEf f ects- >Stop ( ) ; 

break; 

if ( gBngineEnc ) 

return gBngineEnc- >Stop ( ) ; 

break; 

if ( gEffectll > 

return gEf fectll->!3top ( ) ; 

break; 
break; 



return FALSE; 



void PeelEndAllEf f ecta ( void ) 
{ 



if 


( 


gEffectl ) 


gEffectl- 


>Stop() ; 


if 


( 


gE££ect2 ) 


gEf fect2- 


>Stop{) ; 


if 


( 


gEffecta ) 


gEffect3- 


>StOp() ; 


if 


< 


gEffectl ) 


gEf f ect4- 


>StOp() ; 


if 


( 


gEffectS ) 


gEf f ectS- 


>StOp () / 


if 


( 


gEffeck6 ) 


gEf f ectfi- 


>StOp ( ) ; 


if 


< 


gEffect7 ) 


gEf fect7- 


>Stop () ; 


if 


( 


gEfEectfl ) 


gEff ectfl- 


>StOp () ; 


if 


( 


gB££ect9 } 


gEf f ect9- 


>StOp{) ; 


if 


( 


gEffectll) 


gEffectll 


- >Stop ( ) ; 


if 


( 


gPorce ) 


gPorce->stop() ; 


if 


( 


gBngineEnc 


gEngineEnc->Stop 0 ; 



long FeelEnclosureBf feet (short effectNum, long left, long 

top, long eight, long bottom) 

{ 

// Prepare a rect... 

RECT r » { left, top, right, bottom } ; 

// Try doing the enclosure, depending on which 
effect they want... 

switch { effectNura ) 
I 

BOOL success; 
case 3t 

if ( l gB££ect3 ) return FALSE; 
success » 

( (CForceEllipae*) gEf fecL3) - >ChangeParameterB ( 
tr. 

PORCB_E FFECT_DONT_CH ANGE , 
FORCE_E P FECT_DONT_CH ANG E , 
PORCB_EFFECT~DONT_CHANGE, 
FORCE_E PFBCT_DONT~CHANGE , 
FORCE~EFFECT~DONT~CHAJNGE , 

(CForceEffectM FORCE E FFECT_DONT_CHANGE 
)l 

if { ! success ) return FALSE; 
return gEf £ect3- »Start () ; 
break; 
case 4 i 

if ( ! gE££ect4 ) return FALSE; 
success « 

( (CForceEllipse*)gEEfect4) ->ChangeParameters ( 
tr. 

force_e ffect_dont_chanqe , 
porce_bffect~dont_change. 
force effbct~dont_change, 

PORCE~EFFBCT_D0NT_CHANGE, 
FORCE_BFFECr DO NT CIIAWGB, 

(CForceEf fectM FORCE EPFECT_DONT_CMANGB 



) f 



if ( ! success ) return FALSE ; 
return gEf f ect4->Start ( ) ; 
break; 
case 10i 

if ( ! gBngineEnc ) return FALSE; 
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success - 

( (CForceEnclooure* > gEnglneEnc) - >ChangeParatneters ( 
&r, 

PO RC E_ E F P ECT_DONT_CH ANG E , 
FORCB_EFFECT_D0NT_CKA-NGE , 
FORC8~EFFECT~D0NT~CHANGE , 
FORCE~EFFECT DONT~CHANGE, 
FORCE_EPFECTJX>NT_CHAWaB. 
FORCE_EFFECT~DONT_CHANGE , 
FORCE EFFECT DOHT_CHANGE, 
FORCE_EFFECT~DONT_CHANGE , 

( CForceEf fee t * ) FORC E_E P FECT__DONT_CH ANOE 



); 



return FALSE; 



if ( I success ) return PALSE; 
return gEnglneEnc- >Start () ; 
break; 

// These effects don't use enclosures! 

case li 

case 2 i 

caBe Si 

case 6 i 

caBe 7 i 

case 8 i 

case 9 i 

default i 

return FALSE; 

// Have this just in case... 



long PeelBeginPorce ( long Xdir, 
{ 

// if ( gPorce ) 



long Ydir, long Mag ) 



// 
// 
// 
// 
// 
// 
// 
// 



{ 



POINT myPt « { Xdir, Ydir ) f 
gForce- >ChangeParameters { 
myPt, 

FORCE_EFFECT_DONT__CHANGE , 
Mag "* . 

)/ 



. return 0; 



long FeelEndForce( void ) 
{ 

// if ( gForce ) 

// return gForce - >S top() ; 

return 0; 

) 



howtodat.txt 

This file shows an outline of the effects.dat file. 
Everything is a DWORD and describes a parameter for 
the initialization of an effect. 

Here's the order i 

// LASER Periodic 

// ICE Damper 

// METEOR Ellipse 

// DENIM Texture 

// ENGINE Periodic 

// RAQUET STRING Grid 

// RAQUET Ellipse (uses Grid) 



Here 1 s 


the actual value descriptions 


(in shorthand) t 


LDUR 


LMAG 


LPER 


IX)FP 


LPHA 


IVIS 


I SAT 


IVEL 






MSTIFF 


MWW 




MS AT 




DPOSK 


DNEGK 


DPOSS 


DMEGS 


DDEAJ3 


EDIRX 


EDIRY 


BDUR 


EMAG 


EPER EOFP 




EPHA 








SPOSK 


SNEGK 


SPOSS 


SNEGS 


SDEAD 


RSTIFF 


RWW 




RSAT 





Here's the default values i 
// Laser 

DWORD LDUR - 400, LMAG - 4 00O. LPER - 10, LOFP - 0, L 
// ICE 

DWORD IVIS = -4000, ISAT » 8000, IVEL - 10; 
// METEOR 

DWORD MSTIFF -4000, MWW - 20, MS AT « 8000; 
// DENIM 

DWORD DPOSK - 8000, DNEGK • 80O0. DPOSS - SO . DNEGS « 
DDEAD - 11; , 
// ENGINE 

DWORP EDIRX - 1. EDIRY - 1, EDUR-10000. EMAG-4500, 
BPER-20, EOFF-0, EPHA- 180; 
// RAQUET STRING GRID 

DWORD SPOSK- 3 000, SNEGK-3 000, SPOSS- 3 00 0. SNEGS- 3000. 

SDEAD-20; 

// RAQUET ELLIPSE 

DWORD RSTIFF - 2000, RWW - 20, RSAT - 8000; 



Here's the initialization code that uses theroi 
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// Create effect 1 - LASER (PERIODIC SINE (1,0) 750 3023 10 
0 0) 

gEtfectl - new CPorcePeriodic ( ) i 
i f ( I gEffectl ) goto FS_Err f 

euccesB - ( (CPorcePeriodic* ) gEf Cectl )- ^Initialize ( 
gMouse, 
GUIDSine, 

FORCE^PERIODICJJBPAULTJMRECTIOH, 

LDUR." // - 
FORCE_PERIODIC_DEPAULT DURATION 

LMAG, // •» 

F0RCE_PER 10D I C_DEFAULT_MAGN I TUDB 

LPER, // - 

FORC B__P E R 1 0 D I C_DE FAULT PERIOD 

LOFF, // - 

FORCE_PERIODIC_DEFAULT_OPFSBT 

LPKA // - 

FORCE PERIODIC DEFAULT PHASE 



if ( 1 aucceae ) goto FS_Err,- 



// create effect 2 - ICE (DAMPER -1000 8000 0 -1) 
gEf feet 3 b new CForceDamper ( ) / 
if ( I gEffect2 ) goto FS_Err; 

success - ( (CForceDamper* ) gEf fect2) -^Initialize ( 
gMouse, 
IVIS, // - 

FORCE_DAM PER_DEPAULT_V I SCOS ITY 

ISAT, // - 
FORCE_DAM PE R_DE FAULT_S ATU RAT ION 

IVEL, // » 
FORCB_DAMPER_DEFAULT_M INJVELOC ITY 

FORCE EFFECT_AXIS_BOTH 

), 

if ( I success ) goto FS_Err; 

// Create effect 4 - METEOR (ELLIPSE -1 -l 2000 -I -l -1 -1 
-1 8) 

gEffect4 - new CForceEllipse; 
if ( ! gEffect4 ) goto FS_Err ; 

success - ( (CForceEllipse* JgEf f ect4 > -initialize ( 
gMouse, 

FORCE ELLIPSE DBFAULT_WIDTH, 
FORCB~ELLI PS E~DEFAULT_H EIGHT, 
MSTIFF. // - 
FORCB_ELLI PSE_OEPAULT_STIFFNESS 
MWW, 
MS AT, 

SERRA_FSTIFF_OUTBOUNDANYWALL, 
//FORCE_ELLIPSE~DEFAULT_STIPFNESS_MASK, 

FORCE ELLIPSE DBFAULT_CLI PPING MASK, 
FORoTeLL I PSE~DEFAULT_CENTER_POINT, 
NULL 

)/ 

if ( l success ) goto FS_Err; 

// Create effect 5 - DENIM (CONDITION TEXTURE ???? ) 

gEffectS - new CForceCondition; 

if ( I gEffectS ) goto FS_Err ; 

success - ( (CForceCondition* ) gEffectS) - 
>Initialize( 

gMouae, 

GUID_SerraVTexture, 
DPOSK, 
DNEGK, 
DPOSS , 
DNEGS , 
DDEAD, 



//PosK 
//NegK 

,//PosSat - period in pixels 
//NegSat - period in pixels 
//Deadband - no bump in pixels 
FORCE_BPFECT_AXIS_X. 

FORCE_COND I T ION_DB FAULT_CENTER_POl NT 



) ; 
if 



( I success ) goto FS_Err; 



l) loooo 



// Create effect 6 - MOTOR (PERIODIC SQUARE {l, 
6500 20 0 180) 

gEffectS - new CPorcePeriodic ( ) ; 

if ( 1 gEffecte ) goto FSJSrr; 

success - ( (CForcePeriodic*) gEffectS) -initialize ( 
gMouae, 
GUID_Square, 

CPoint (EDIRX, BDIRY) , // - 
FOR C E_PER 1 0 D 1 C_DEFAULT_D I RECT I ON 
EDUR, 

F0RCE_PERIODIC__DEFAULT_DURATION 
EMAG , 

F0RC E_ P £ R I OD I C_DE FA ULT_MAGN I TUDE 
EPER, 

F0RCB_PERIODIC_DEFAULT_ PERIOD 
EOFP, 

FORCE_ PE R I OD I C_DE PAU LT_0 F FS ET 
EPHA 

FORCE_ PER IODIC DEFAULT_ PHASE 
)/ 

if ( ! succeaa ) goto FS_Err; 

// Create effect 7 » RACQUET__GR I D (CONDITION GRID) 

gEf feet 7 m new CForceCondition.- 

if ( I gBffect7 ) goto FS_Err; 

success ■ ( (CForceCondition* )gEffect7) - 
initialize ( 

gMouse, 

GUID Setra Grid, 
SPOSK, 7/PoaK 



// 
// 
// 
// 

. // 
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pixels 



SNSGK, 
SPOSS, 
SNEGS, 
SDEAD, 



//NegK 
//PoaSat 
//NegSat 
//Deadband 



grid spacing in 



FORCE_BFFECT AXIS_BOTH, 

FORCE CONDITION DEFAULT CENTER POINT 



) ; 

if ( I succeaa ) goto FSJgrr; 

// Create effect 3 » RACQUET (ELLIPSE -1 -1 2000 - 
1 -1 -1 -1 -1 8) 

// Make 3 after 7 because 3 Is dependent on 7 
gEffect3 » new CForceEllipse; 
if < ! gEffect3 ) goto PSJ3rr ; 

auccess » ( (CForceEllipse* )gEE feet 3) -initialize ( 
gMouse, 

FORCE_ELLI PSE_DEFAULT_WI DTH , 
FORCE ELLIPSE DEFAULT~HEIGMT, 
RSTIPF, // - 
FORCE_ELLIPSE_DEFAULT STIFFNESS 
RWW, 
RSAT. 

SERRA_PSTIPF_OUTBOUNDANYWALL, 
//F0RCE_ELLlPSE_DEFAULT STI FFNESS_MASK, 

FORCE_ELL I PSE~DE FAULT_CL I P P I NG_MASK , 
FORCE_ELLIPSE_DEFAULT__CENTER POINT, 
gEffect7 

) » 

if ( l success ) goto FS_Err; 



effects.dat 



1 


1 


1000 


10000 


158 


0 


-1 


0 

1 

0 


1000 


6744 


13 


0 


-4000 


8000 


10 








4000 


20 


8000 








8000 


8000 


50 


50 


11 




0 


1 


2000 


S968 295 


0 


0 


3000 


3000 


3000 


3000 20 






2000 


20 


8000 








1 


0 


3500 


10000 100 


0 


0 


10000 


390697 


1 


967441 






0 


2572093 


10000 


830232 






3953 


144186 


387 


641860 






10000 


283720 


0 


0 







FeelControlCtl.h 

(defined (AFX_FEELCONTROLCTL_H 7BACF77 3_5CC1 11D1_A868_0 06 00 

83A2742 INCLUDED^) 

fldefine 

AFX_FEBLCONTR0LCTL_H 7BACP773_5CC1_11D1_A86 8 0060083A2742 

INCLUDED 



ftif _MSC_VER >=* 1000 

Ifpragma once 

flendif //'_MSC_VER >- 

// FeelControlCtl.h t 
ActiveX Control class. 



1000 

Declaration of the CFeelControlCtrl 



/////////////////////////////////////////////////////////// 
// CFeelControlCtrl i See PeelControlCtl . epp for 
implementation . 

class CFeelControlCtrl t public COleControl 
( 

D ECLARE_D YNCREATE (CFeelControlCtrl ) 

// Constructor 
public. 

CFeelControlCtrl () ; 
// Overrides 

// ClaeeMizard generated virtual enaction 

overrides 

// ( {AFX_VIRTUAL (CFeelControlCtrl) 
public i 

virtual void OnDraw(CDC* pdc, const CRectfi 
rcBounds, const CRect6 rclnvalid) / 

virtual void DoPropExchange (CPropBscchange* pPX); 
virtual void OnReeetS tate ( ) ; 
virtual DWORD GetControlPlags ( ) / 
//}}AFX_VIRTUAL 

// Implementation 
protected i 

-CFeelControlCtrl () ; 

DECLARE_OLSCREATE_RX (CFeelControlCtrl) // Class 
factory and guid 

DECLARB_OLBTYPELIB (CFeelCont rolCtr X) // 
GetTypelnfo 
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1)ECLARE_PR0P PAGE IDS (CPeelControlctrl) // 
Property page I Do 

DECLARE_OLECTLTV PE (CFeel Cont rolCt r i ) 
// Type name and tniec status 

// Message inaps 

//{ {AFX_MSG(CFeelControlCtrl) 

// NOTE - ClassWizard will add and 
remove member Cunctiona here. 

// DO NOT EDIT what you see in these 
blocka of generated code I 
//)}AFX_MSG 
DECLARB_MESSAGB_MAP ( > 

// Dispatch maps 

// { {APX_DISPATCH (CPeelControlctrl) 
afx_msg BSTR GetEf f ectl { ) ; 

afx_msg void SetEf fectl (LPCTSTR lpszNewValue) ; 
afxjnsg BSTR GetE£fect2 () / 

afx_mBg void SetBffect2 (LPCTSTR lpszNewValue); 
a£x_msg BSTR GetEf £ect3 ( ) ; 

afxjnsg void SetBf feet 3 {LPCTSTR lpszNewValue); 
afx~msg BSTR Ge tEf f ect4 ( ) ; 

afx_msg void SetEf fee t4 (LPCTSTR lpszNewValue); 
afx~mag BSTR GetBff ect5 ( ) ; 

afxjnsg void SetEf fect5 (LPCTSTR lpszNewValue)/ 
afxmsg BSTR GetEf fect6 () ; 

afx_msg void SetSftecte (LPCTSTR lpszNewValue); 
afxmug long DoEf f ect ( Bhor t effectNum);- 
afx__msg long Stop&f feet (short effectNum); 
afx_msg void StopAlK)/ 

afx_mag long SetEf feet (short effectNum, LPCTSTR 
ef f ect Pa rams) ; 

afx_msg long DoBnclosureBf feet (short effectNum, 
long left, long top, long right, long bottom)/ 

afx_msg long ApplyForce (long Xdir, long Ydir, long 

Hag); 

afx mag long StopPorce ( ) ; 
//)JaPX_D IS PATCH 
DBCLARE_DISPATCH_MAP ( ) 

// Event maps 

//{{AFX EVENT(CFeelControlCtrl) 
//) }AFX~EVENT 
DECLARE_EVE»nVMAP ( ) 

// Dispatch and event IDs 
public t 

enum { 

// { (APX_DISP_ID(CFeelControlCtrl) 
dispidEf fectl - 1L, 
dispidEffect2 - 2L, 
diopidEffect3 - 3L, 
dispidEf fect4 m 4L, 
dispidEf fectS « 5L, 
dispidEf fect6 - 6L, 
dispidDoEffect - 7L, 
diepidStopEf feet - BL, 
dispidStopAll - 9L, 
dlspidSetEf f ect - 10L, 
diapidDoEnclosureEf f ect » 11L, 
dlspidApplyPorce « 12L, 
dispidStopForce o 13L, 
//}}AFX_DISP_ID 

}; 

)' 

// ( { AFX_INSERT_LOCATI0N) } 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. 



flendif // 

I def ined ( AFX_PEBLCONTROLCTL_H_ 
83A2742 INCLUDED) 



78ACP773 5CC1 11D1 A86B 00600 



FeelControlCtl.cpp 



// FeelControlCtl.cpp i Implementation of the 
CPeelControlctrl ActiveX Control class. 

Hinclude "Btdafx.h" 
flinclude <objaafe.h> 
fiinclude <comcat.h> 
(J include "Feel Control . h" 
flinclude "FeelControlCtl .h- 
ft include "FeelControlPpg . h" 
8 include " Peel Forces .h" 

HRESULT CreateComponentCategory( CAT 3D cat id, WCHAR* 
catDescription ); 

HRESULT RegisterCLSlDInCategory ( RBFCLSID clsid, CAT I D catid 
); 

HRESULT UnregisterCLSIDInCategory ( REFCLSlD claid, CATID 
catid ); 

tfifdef _DEBUG 

Ode fine new DEBUG_NEW 

Hundef THIS_PILB 
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static char THIS PILE (] 
ftendlf 



_PILB_; 



"Bffectl", 
"Ef fect2", 
"Bffect3«\ 
"Effect4". 
"Effects", 
"Ef fect6", 



"DoEf feet", 
"StopEffect", 
"StopAll", 
"SetEf feet", 

VTS 12 VTS 14 



IM PLEM ENT_D YNCR EATE (CPeelControlctrl. COleControl) 

/////////////////////////////////////////////////////////// 
// Message map 

BEGIN MESSAGE MAP (CPeelControlctrl , COleControl) 

//{ {afx_msg_MAP (CPeelControlctrl) 

// NOTE - ClassWizard will add and remove message 
map entries 

// DO NOT EDIT what you see in these blocks of 
generated code I 

//})AFX_MSG_MAP 

ON^OLEVERB (AFX_IDS_VBRB_PROPERTIES, OnProperties) 
END__M ESS AG E_MA P ( ) 

///////////////////.//////////////////////////////////////// 
// Dispatch map 

BEGIN__DISPATCH_MAP (CPeelControlctrl, COleControl) 

//{{AFX DISPATCH_MAP (CPeelControlctrl) 

DlSP_PR0PERTY_Ex7cFeelControlCtrl, 
GetEffectl, SetEffectl, VT_BSTR) 

DISP_PR0PERTY_EX (CPeelControlctrl, 
GetEffect2, SetEffect2,""vT_BSTR) 

DlSP_PR0PERTY_Ex7cFeelControlctrl, 
GetEf fect3, SetEf fect3, VT__B STR ) 

DISP_PROPERTY_EX (CPeelControlctrl , 
GetEf fect4. SetEf fect4, VT_BSTR) 

DISP_PROPERTY_EX (CPeelControlctrl, 
GetEf fectS, SetEf fect5. VT_BSTR) 

DISP_PROPERTY_EX (CPeelControlctrl, 
GetEf fect6, SetEf fect6, VT_BSTR) 

DISP^FUNCTION (CPeelControlctrl, 
DoEf feet, VT_I4, VTS 12) 

DISP FUNCTION (CPeelControlctrl, 
StopEf feet, VT~I4, VTS 12) 

DISP_FUNCTION(CFeelControlCtrl, 
StopAll, VT_EMPTY, VTS_NONE) 

DISP FUNCTION (CPeelControlctrl, 
SetEf feet, VT_I4, VTSI2 VTS_BSTR) 

DISP_FUNCTION(CFeelControlCtrl, 
M DoBnclosureBf feet" , DoEnclosureEf feet, VT_I4, 
VTS_I4 VTS_I4 VTS„I4) 

DISP_FUNCTION(CFeelControlCtrl, "ApplyForce" 
ApplyForce, VTI4, VTS_I4 VTS_I4 VTS_I4) 

DlSP_FUNCTION(CFeelControlCtrl, "StopForce" , 
StopPorce, VT_I4, VTS_NONB) 

/ / ) } AFXD I S PATCH_MA P 
ENDJ3ISPATCH MAPO 



/////////////////////////////////////////////////////////// 
// Event map 

BEGIN_EVENT_MAP(CFeelControlCtrl, COleControl) 
// { { APX_EVENT_MAP (CPeelControlctrl ) 
// NOTE - ClassWizard will add and remove event 

map entries 

// DO NOT EDIT what you see in these blocks of 
generated code I 

//})AFX_EVEHT_MAP 
END EVENT MAP() 



/////////////////////////////////////////////////////////// 
// Property pages 

// TODOi Add more property pages as needed. Remember to 
increase the count I 

BEGIN_PROPPAGEIDS (CPeelControlctrl, 1) 

PROPPAGBID(CFeelControlPropPage * iguid) 
END PROPPAGEIDS (CPeelControlctrl) 



/////////////////////////////////////////////////////////// 
// Initialize class factory and guid 
IMPLEMENT^ OLECREATE_EX (CFeelControlCtrl, 
" PEELCONTROL . FeelControlCtrl . 1 " , 

0x5dfdd466, 0x5b37, Oxlldl, OxaB, 0x68, 0, 0x60, 
OxB, 0x3a, 0x27, 0x42) 



/////////////////////////////////////////////////////////// 
// Type library ID and version 

IMPLEMEHT_OLETYPEL.IB (CPeelControlctrl, __tlid, _wVerMajor, 

_wVer Minor) 



/////////////////////////////////////////////////////////// 
// Interface IDs 

const I ID BASED_CODE I ID_ DFeelControl - 

{ 0x78acf765, 0x5ccl, Oxlldl, { OxaB. 
0x68, 0, 0x60, 0x8, 0x3a, 0x27, 0X42 } }/ 
const I ID BASEDCODE I ID_DPeelControl Events - 

{ 0x78acf766. OxSccl, Oxlldl,. ( OxaB. 
0x68, 0, 0x60, 0x8, 0x3a, 0x27. 0x42 } }/ 



/////////////////////////////////////////////////////////// 
// Control type information 

static const DWORD BASED_CODE _dwFeelCont rolOleMisc o 
OLEM ISC^INVISI BLBATRUNT1ME | . 
OLEMISC_ACTIVATEHHBNVISIBLE | 
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its 

III 

zip 



P 



IP 



OLEM1SC_IGNOREACTIVATEWHENVI8IBLE | 
OLEMI SC~S 13TCLI ENTSITBFI RST | 
OLEMI SC I NS I DEOUT | 
OLEMIfiC""CANTLI NK1W3 IDE | 
OLEMISC~RBCOMPOSEONRESIZEf 

IMPLEMENT_OLECTLTYPE (CFeelControlCt rl , lDS_FEELCONTROL. 
_dwPee ICont rolOl eMi bc ) 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrli iCFeelControlCtrlFactory f lUpdateRegistry 

// Adds or removes system registry entries for 
CFeelControlCt rl 

BOOL 

CPeelControlCtrl i iCFeelControlCtrlFactory* ■ UpdateRegistry (BO 

OL bRegister) 

{ 

// TODOt Verify that your control follows 
apartment -model threading rules. 

// Refer to MFC TechNote 64 for more information. 

// If your control does not conform to the 
apartment -model rules, then 

// you must modify the code below, changing the 
6th parameter from 

// afxRcgApartmentThreadlng to 0. 

if (bRegister) 

{ 

CreateComponentCategory ( CATID_Control, - 

L"Controla" ); 
Regis terCLS ID InCategory ( m_cleid, 

CATID_Control ) ; 

CreateComponentCategory ( 
CATID_SafeFor Initializing. 

L*Controls safely initializable from persistent data" ) ; 

RegisterCLSIDInCategory ( mclBid. 
CATID_SafeForInitializing ); 

CreateComponentCategory ( 
CATI D_Sa fePorScr ipting, 

I, "Control a that are safely scriptable" ) / 

Regis terCLSIDInCategoryt m_clsid, 
CATID__Sa£eForScripting ) ; 

CreateComponentCategory ( 
CATID_Persist6ToPropertyBag ( 

L"Support initialize via PeraistPropertyBag" ); 

RegisterCLSIDInCategory ( m__clsid, 
CATID_PersistBToPropertyBag ) s 

return ACxOleRegisterControlClass ( 
AfxGetlnatanceHandle () , 
m_clsid, 
m_lpszProgID, 
IDS_FEELCONTROl», 
I DB_FBELCONTROL , 
afxRegApartmentThreading, 

dwFeelControlOleMisc, 
"tlid. 
~wVerMajor, 

wVerMinor) ; 

) 

else 
( 

UnregieterCDSIDInCategory ( m_clsid, 

CATIDControl ) ; 

UnregisterCLSIDInCategory ( m_clsid, 
CATID_PeraiBtsToPropertyBag ) ; 

UnregisterCLS IDInCategory ( myeloid, 
CATI D_SaEeForScr ipting ) 

UnregieterCLSIDInCategory( m_clsid, 
CATID_SafeForInitlalizing ); 

return Af xOleUnregisterClaBB (m_clsid, 

m IpszProgiD) t 
) 

) 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrli iCFeelControlCtrl - Constructor 

CPeelControlCtrl t i CFeelControlCtrl ( ) 
I 

Initialize 1 1 Ds(S.IID_DFeelControl, 
&I ID_DFeelControlEvents) ; 

// TODOi Initialize your control's instance data 

here . 

FeelSetup( Af xGet InstanceHandle ( ) , 
AfxOetMainWndO ->ni hWnd ) ; 
) 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrli .-CFeelControlCtrl - Destructor 

CFeelControlCtrl t • -CPeelControlCtrl (I 
( 

// TODOi Cleanup your control's instance data 

here . 

FeelCleanup ( ) ; 

I 



/////////////////////////////////////////////////////////// 
// CFeelControlCtrl • lOnDraw - Drawing function 

r» 

void CFeelControlCtrl ii OnDraw< 

CDC* pdc, const CRectt 
rcBounds, const CRectt rclnvalld) 
I 

// TODOi Replace the following code with your own 
. drawing code. 

pdc- >FillRect (rcBounds, 
CBrushi i FromHandle( (HBRUSll)GetStockObject ( WHITE_BRUSJ1) ) ) ; 
pdc- >Ellipse (rcBounds) ; 

} 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrl i • Do Prop Exchange - Persistence support 

void CFeelControlCtrl « i Do Prop Exchange (CProp Exchange* pPX) 
{ 

ExchangeVerslon (pPX, MAKBLONO (_wVerMinor , 
_wverMajor) ) / 

COleControl » i DoPropExchange (pPX) ; 

/'/ TODOt Call PX_ functions for each persistent 
custom property. 
) 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrli iGetControlFlago - 
// Flags to customize MFC's implementation of ActiveX 
controls . 

// For information on using these flags, please see MFC 
technical note 

// Ifnnn, "Optimizing an ActiveX Control". 
DWORD CFeelControlCtrli i Get Control Flags () 
{ 

DWORD dwFlags ■ COleControl t iGetControlFlags ( ) i 
// The control can activate without creating a 

window. 

// TODOi when writing the control's message 
handlers, avoid using 

// the m_hwnd member variable 

without first checking that its 

// value 1b non-NULL. 

dwFlags |» windowleaeActivate; 

// The control can receive mouse notifications 
when inactive. 

// TODOi if you write handlers for WM_SETCURSOR 
and WM_M0USEM0VE, 

// avoid using the m_hWnd member 

variable without first 

// checking that its value is 

non-NULL. 

dwFlags 1» pointerlnactive/ 
return dwPlago; 

} 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrl i i OnResetState - Reset control to default 
state 

void CFeelControlCtrl. lOnReaetStateO 
{ 

COleControl i iOnResetState() ; // Resets defaults 
found in DoPropExchange 

// TODOi Reset any other control state here. 

} 

/////////////////////////////////////////////////////////// 
// CFeelControlCtrl message handlers 

long CFeelControlCtrl i iDoBf feet (short effectNum) 
{ 

// TODOi Add your dispatch handler: code here 
return FeelBeginEf f ect ( effectNum ); 

) 

long CFeelControlCtrli i StopBf feet (short effectNum) 



// TODOi Add your dispatch handler: code here 
return FeelEndEf feet ( effectNum )/ 



} 

void CFeelControlCtrl » iStopAHO 
{ 

// TODOt Add your dispatch handler; code here 
FeelEndAllEffectsO / 

) 

long CFeelControlCtrl i tApplyForce{ long Xdir, long Vdir, long 

Mag ) 

{ 

return FeelBeginForce ( Xdir, Ydir, Mag >/ 

) 

long CFeelControlCtrli iStopForceO 
{ 

. return PeelEndForce ( ) ; 

) 
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ong CFeeiControlCtrl i iDoEnclooureEEfect (ohort effectNum, 
ong left, long top, long right, long bottom) 

// TODOi Add your dispatch handler code here 
return FeelEnclosureBf f ect ( effectNum. left, top, 
right , bottom J ; 



ong CFeeiControlCtrl i tSetEf feet (short effectNum. LPCTSTR 
Cf ect Paramo) 

// TODOi Add your diopatch handler code here 

return 0; 

BSTR CFeeiControlCtrl i iGetEffectlO 
CString BtrResult; 

// TODO. Add your property handler here 
return BtrResult . AllocSyoStrLng { ) ; 

void CFeeiControlCtrl! i SetEEf ect 1 (LPCTSTR IpszNewValue) 
// TODOi Add your property handler here 
' SetModifiedFlagO ; 

BSTR CFeeiControlCtrl! iCetEf £ect2 () 
CString BtrResult; 

// TODOt Add your property handler here 
return etrReault .AllocSyaString () ; 

void CFeeiControlCtrl i .SetEffect2 (LPCTSTR IpszNewValue) 
// TODO i Add your property handler here 
SetModifiedFlagO ; 

BSTR CFeeiControlCtrl » ; GetEff ect3 ( ) 
CString BtrResult; 

// TODOi Add your property handler here 
return strReBult .AllocSyaString ( ) / 

void CFeeiControlCtrl i »SetEf f ect3 (LPCTSTR IpszNewValue) 
// TODOi Add your property handler here 
SetModifiedFlagO; 

BSTR CFeeiControlCtrl! iGetE£fect4(> 
CString strReault; 

// TODOi Add your property handler here 
return strReault . AllocSyaString () ; 

void CFeeiControlCtrl. iSetEffect4 (LPCTSTR IpszNewValue) 
// TODOt Add your property handler here 
SetModifiedFlagO ; 

BSTR CFeeiControlCtrl i iGetEf £ect5 () 
CString etrReault; 

// TODO i Add your property handler here 
return BtrResult . AllocSysString O > 

void CFeeiControlCtrl i i SetEffectS (LPCTSTR IpszNewValue) 
// TODOi Add your property handler here 
SetModifiedFlag O ; 

BSTR CFeeiControlCtrl t t Get Effects ( ) ■ 
CString BtrResult; 

// TODOi Add your property handler here 
return at rReeult . AllocSyaString O ; 



void, CFeeiControlCtrl i iSetBf £ect6 (LPCTSTR IpszNewValue) 
// TODOi Add your property handler here 
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SetModifiedFlagO ; 



H RESULT CteateComponentCategory( CAT ID catid, WCHAR* 
catDeacription ) 



ICatRegister* 
H RESULT 



per - NULL; 

hr - S_0K; 



// Create an Instance of the category manager 
hr - CoCreate Instance ( 

CLS1D StdComponentCategorleaMgr, 

NULL, ~ 

CLSCTX_INPROC_SERVER, 
HD_ICatRegister, 
(void**)&pcr 
)/ 

if (FAILED (hr) )' 

return hr; 

CATEGORY INFO catinCo; 
cat info. catid « catid; 

catinfo.lcid - 0x0409; // English locale ID in hex 

int len » wcslen( catDeacription ) / 

wcsncpy( catinf o. szDeecrlption, catDeacription. 

catinf o. szDescription(len) ■ »\0'j 

hr » pcr->RegisterCategories( 1, tcatinfo ); 

per- >Release ( ) ; 

return hr; 



H RESULT RegisterCLSlDlnCategory(REFCLSID claid. CATID catid) 



len ); 



{ 



ICatRegister* per - NULL ; 
II RESULT hr - S_0K; 

// Create an instance of the category manager 
hr - CoCreate Instance ( 

CLSID_StdComponentCategoriesMgr, 

NULL, 

CLSCTX_INPROC_SERVBR, 
XX D_ I Ca tReg i e t er , 
(void**)&pcr 

>; 

if (SUCCEEDED (hr) ) 
{ 

CATID rgcatid{lj ; 
rgcatid(0] - catid; 

hr - pcr->RegisterClassImplCategories( 

rgcatid ) ; 
) 

if ( per l~ NULL ) 

pcr->Release () ; 

return hr; 



HRBSULT UnregieterCLSlDInCategory( REFCLSID clsid, CATID 
catid ) - 



ICatRegister* per « 
HRESULT hr « S_OK; 



NULL; 



claid, l, 



// Create an inotance of the category manager 
hr - CoCreatelnstance (. 

CLSID_StdComponentCategoriesMgr, 

NULL, 

CLSCTX_INPROC_SERVER , 

IID_ICatRegieter, 

(void**Upcr 

) ; 

if (SUCCEEDED (hr) ) 
{ 

CATID rgcatid U) ; 
rgcatid 10] - catid; 

hr - pcr->UnRegisterClasBlmplCategories( 

rgcatid ) ; 
> 

if ( per !« NULL ) 

pcr->Releaae() ; 

return hr; 



FeelControlPpg.h 

IIU 

! deE ined (AFX_FEELC0NTR0LPPG_H 78ACF77-i_SCCl_llDl_A860_OO6OO 

B3A2742 INCLUDED^) 

fldefine 

AFX_FBELCONTROLPPa_JI 7 8ACF775_5CC1_11O1_A06 8_O0600B3A2742 

INCLUDED^ 

Bif _MSC_VER >- 1000 
^pragma once 

fiendif // _MSC_VBR >» 1000 
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// PeelControlPpg.h i Declaration of the 
CFeelCont rol PropPage property page class. 

/////////////////////////////////////////////////////////// 
// CPeelControlPropPage i See FeelCont rol Ppg . cpp .cpp Cor 
implementation. 

claao CFeelControlPropPage « public COlePropertyPage 

DECLARB_DYNCR BATE {CFeelControlPropPage ) 
DECLARE~OLECREATE_BX (CPeelControlPropPage) 

// Constructor 
public i 

CPeelControlPropPage () / 

// Dialog Data 

// { { AFX_DATA (CFeel Control PropPage ) 

enum { IDD ■ IDD_PROPPAGE_FEBLCONTROL } ; 

// NOTE - ClassWizard will add data 

members here. 

// DO NOT EDIT what you see in theee 
blocks of generated code 1 
//)}AFX_DATA 

// Implementation 
protected! 

virtual void DoDataExchange (CDataExchange* pDX) ; 
// DDX/DDV support 

// Message maps 
protected* 

// { {afx_msg (CFeelControlPropPage) 

// NOTE - ClassWizard will add and 
remove member functions here . 

// DO NOT EDIT what you. see in these 
blocks o£ generated code I 
//)}AFX_MSG 
DECLARE_MESSAGE_MAP ( ) 

); 

//{ (AFX_ INS E RELOCATION } } 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. 

flendif // 

!def tried (AFX_PEELCONTROLPPO_H_78ACF775_SCC1_11D1_A868_00600 
83A2742 INCLUDED) 



FeelControlPpg.cpp 

// FeelControlPpg.cpp i Implementation of the 
CPeelControlPropPage property page class. 

flinclude "stdafx.h" 
flinclude "FeelControl.h H 
flinclude "PeelControlPpg.h" 

Hifdef _DEBUO 
ffdefine new DEBUG NEW 
flundef THIS_PILB 

static char~THIS_PILE (] • PILE ; 

flendif 

IMPLEMENT_DYNCREATE < CFeelControlPropPage , COlePropertyPage) 

////////////////////////////////////////////////////////// 
// Message map 

BEG I N_MESSAGE_MAP( CFeelCont rol Prop Page, COlePropertyPage) 
// {*(AFX_MSG_MAP (CFeelControlPropPage) 
// NOTE - ClassWizard will add and remove message 

map entries 

// DO NOT EDIT what you see in these blocks of 
generated code I 

//))AFX MSG_MAP 
END_MESSAGE_MAP ( ) ~ 

////////////////////////////////////////////////////////// 

// Initialize class factory and guid 

IM PL EM ENT OLECREAT£_EX ( CFee ICon t rol PropPage , 

"FEEliCONTROL . FeelControlPropPage .1%. 

0X78801767, 0X5CC1, Oxlldl, OxaB, 0x68, O, 0x60, 

0x8, 0x3a, 0x27, 0x42) 

////////////////////////////////////////////////////////// 
//CFeelControlPropPage • iCFeelCont rolPropPageFactory i lUpdateR 
egistry - 

// Adds or removes syHtem registry entries for 
CFeelControlPropPage 

BOOL 

CFeelControlPropPage! i CPeelCont rol PropPage Factory ■ lUpdateReg 
istry(DO0L bRegister) 

if (bRegister) 

return 

Af xOleRegisterPropertyPageClasB (Af xGetlnstanceHandle ( ) , 

m_clsid, IDS_PEELCONTROL_PPG) / 

else 



return AExOleUnregioterClass (ra_clnld, 

NULL) ; 
} 

/////////////////////////////////////////////////////////// 
// CFeelControlPropPage i {CPeelControlPropPage - Constructor 

CFeelControlPropPage! t CFeelControlPropPage ( ) t 

COlePropertyPage (IDD, IDS_FEKLC0NTROL_PPG_CAPTION) 

/ / { { A PX__DATA_I NIT (CFeelCont rol Prop Page) 
// NOTE i ClassWizard will add member 

initialization here 

// DO NOT EDIT what you see in these blocks of 

generated code I 

//)}AFX_DATA I NIT 

) 

/////////////////////////////////////////////////////////// 
// CFeelControlPropPage . • DoDataExchange - Moves data between 
page and properties 

void CFeelControlPropPage i t DoDataExchange (CDataExchange* 

pDX) 

( 

// ( (AFX_DATA_MAP( CFeelControlPropPage) 

// NOTE i ClassWizard will add DDP, DDX, and DDV 

calls here 

// DO NOT EDIT what you see in these blocks of 
generated code I 

//} }AFX_DATA_MAP 

DDP Post Processing {pDX) / 

) 

/////////////////////////////////////////////////////////// 
// CPeelControlPropPage message handlers 



. Resource.h 

// ( (NO^DEPENDENCIES) } 

// Microsoft Visual C++ generated Include file. 



// Used by FeelControl . rc 
8 define IDS_FEELCONTROL 1 
H define IDS FEELCONTROL_PPG ' 2 

8 define ids~feelcontrol_ppg_caption 200 

fl define IDD_PROPPAGE_FEELCONTR0L 200 

II define IDB_PEELCONTROL 1 

II define _APS_NEXT_RESOURCE_VALUB 201 

fl define _aps_next_control_value 201 

JJ define. ~APS~NEXT_SYMED_ VALUE 101 
II define _APS_NEXT_C0MMAND_VALUB 327G8 



StdAfx.h 

Hif 

I defined (AFX_STDAFX_H 78ACF76A_5CC1_11D1_A868_0060083A2742 

INCLUDED^) 
fl define 

AFX_STDAFX_H 7 8ACF76A_5CC1_11D1_AB6B_0 0600 8 3A2742 INCLUDED 

81 f _MSC_VER >- 1000 
Upragma once 

Hendif // _MSC_VER >- 1000 

// stdafx.h t include file for standard system include 
files, or project specific include files that are used 
frequently, but are changed infrequently 

Udefine VC_EXTRALEAN // Exclude rarely -used stuff 

from Windows headers 

flinclude <afxctl.h> // MFC support for ActiveX Controls 

// Delete the two includes below if you do not wish to use 
the MFC database classes 

{(include <afxdb.h> // MFC database classes 

ninclude <afxdao.h> // MFC DAO database classes 

/ 

// ( { A FX_ I NS ERT__LOCAT I OH ) ) 

// Microsoft Developer Studio will insert additional 
declarations Immediately before the previous line, 
flendif // 

!defined(AFX_STDAFX H_78ACP76A_5CC1_11D1 A868 006008 3A274 2_ 
_IWCLUDED_) 



StdAfx.cpp 

// etdafx. cpp 1 source file that includes just the stnd 
includes 

// stdafx.pch will be the pre-compiled header 

// stdafx.obj will contain the pre-compiled type information 

Hinclude "stdafx.h" 
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APPENDIX C 



Spring.htm — Spring demo, FIG. 13a 



<htmlxhead> 

<TITLE>CompreaB The Spring</TITLE> 

<Btyle> .myStyle { font-family* verdana; color.white ) 
</style> 

<SCRIPT FOR- window EVENT- "onload 0 LANGUAGE- "JavaScript " > 
document . onmousemove « compress; 

</SCRIPT> 

<SCRIPT language- ■ JavaScript ■> 

var aprlngPorceFlagl - false; 
var BpringForceFlag2 m false; 
var BpringForceFlag3 - false; 

var theSpringKl - 10000; 
var theSprlngK2 - 6000/ 
var theSpringK3 - 2500; 
var previousY ■ 10000/ 

function dospring (springDiv. opringlmg, . 
BpringPorcePlag, theSprlngK) 

var xval - event . cllentX; 
var yval - event - clientY ; 
var minHeight; 
var minTop; 

// Check if we're touching spring 
if ( (xval > 
(springDiv .of f BetLef t + opringimg .of EoetLeCc ) ) && 
(xval < 

(SpringDiv. of f setLef t ♦springlmg .of f setLef t+springlmg. of f setW 
idthj) ) 

( 

minHeight - 

springDiv. of f setHeight/3 ; 

minTop - springDiv .of feetTop + 
springDiv. of fsetHeight - minHeight; 

if ( (yval > 

springDiv. of f set Top) && 

(yval < minTop) ) 
{ // in top 2/3 of spring 
if ( 

IspringPorcePlag ) 

{ 

if ( (yval 

< springDiv. of fsetTop+ (springDiv. of fsetHeight / 3) ) J| 

(previousY < springDiv .of f set Top* (springDiv. of fsetHeight / 
3)) ) 

{ // in start Bpring tone 
BpringForceFlag - true; 

DynamicObject . SetSpringK ( theSprlngK ); 
DynamicObject . StartSpring ( event .screenY- 
(event .clientY-springDiv. style. pixelTop) ) ; 

) } 

if (springPorceFlag) 

{ 

springlmg. style. top - (yval -springDiv. of fsetTop) + 

"px"; 

springlmg. style. height - 
(springDiv .of fsetTop* springDiv. of f setHelght-yval) +. "px"; 

) 

I 

else 

if ( yval >- minTop ) // 
springDiv .of £setTop+ springDiv . of fsetHeight 

( // below 1/3 of spring 

if { BpringForceFlag 

> 

{ 

springlmg. style. top - (minTop -springDiv. of fsetTop) 
♦ "px"; // (springDiv. of fsetHeight- 1) + "px",- 

springlmg. style. height - minHeight + "px"; // 1 + 

"px"; 

> 

) 

else 

{ // above spring 

springlmg .style . top 

- 0 + "px"; 

springlmg. style. height - BpringDiv .of fsetHeight + 

"px"; 

if ( springForceFlag 

I 

( 

spclngForcePlag - false; 
DynamicObject . EndSprlng ( ) ; 

} 
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) 

) 

else 

{ // left or right of spring 

Bpringimg .style .top - 0 + 

"px" ; 

springlmg. style. height - 

springDiv. of fsetHeight + "px"; 

if < BpringForceFlag ) 

springForcePlag - 

false; 

DynamicObject .EndSpringO ; 

) . 

) 

return BpringForceFlag; 



function compress {) • 

.{ 

springForcePlagl - doepring ( apringDivl , 
Bprlnglmgl, springForcePlagl, theSpringKl); 

springlmgl. style. width- "144px"; 

springPorcePlagl - dospring ( springDiv2 , 
springlmg2, springForcePlag2, theSpringK2) ; 

spring Img2 . style, width* "96px"; 

springForcePlag3 - dospring (epringDiv3, 
springlmg3, springForcePlag3 , theSpringKl); 

springlmg3 .style .width- "72px"; 

previousY - event .clientY; 

} 

^/script:* 
</head> 

<BODY TEXT="«000000" BGCOLOR-" JfFFFFFF" LINK- " HFPOO00" 

VLINK-"«800080" ALINK- « flOOOOFF" 

BACKGROUND- 11 image s \backgr ound . jpg" > 

< CENTER xTABLE > 

<TR> 

<TDx/TDxTD> 

<CENTER><IHG SRC- 0 images\logo2_red.gif ■ HEIGHT- 90 

WIDTH«.lG2x/CENTER> 

</TDxTDx/TD> 

<TD> 

<CENTER><BxFONT SIZB-+2>Compre88 The 
Springs </FONTx/Bx/CENTBR> 
</TDxTDx/TD> 

<TD>< IMG SRC- "images \mouse.gif" HE1GHT-144 WIDTH»246x/TD> 

<TDx/TD> 

</TR> 

< /TABLE > 

<CBNTER> 

<HR WIDTH- " 100% " ><BR» 
</CENTER> 

cCBNTERxDIV ID- DEBUG INFO> </DIVx/CBNTER> 

<0BJECT ID» "DynamicObject" WIDTH-0 HE I GUT- 0 

CLASSID- "CLSIDiEC296EE6~B36C-llDl-A868-0060 083A274 2" 

CODEBASE- "DynamicControl . CABtfvers ion- 2 , 0, 0. 0"> 

</0BJECT> 

<CENTER> 
<div 

id-springDivl 

style- "position i absolute; lefti!20; topi2l0; 
widthil44; height t 192; overf lowiclip; * 
> 

<img id-springlmgl s tyle- "position • absolute ; 
left«0; topi 0; z- index t -i; " src-" linage s\Springl .gif H > 
</div> , 

<div 

id= springDiv 2 

style-"poBition i absolute; lefti410; topi274; 
width i 96; height i 128; overf low i clip; " 
> 

<img id-springlmg2 b tyle-"posit ion i absolute; 
left i 0; topi 0; z- index t -1; • src-" i mage s\ Spring 2 . gif ■ > 
</div> 

<dlv 

id-springDiv3 

style-"positioniabsolute; left. 645; top«306; 
width i72; height i 96; overf low. dip; ■ 
> 

<img id-BpringImg3 Bbyle-" posit ion i absolute; 
lefttO; topiO/s- indexi -1; " arc-" image s\ Spring 3 .gif "> 
</div> 
< /CENTER* 

<div style»"positioniabaolute; left ^10; topi 430;" > 
<CENTBR> 

<BUTT0N TYPE- "BUTTON" TITLE- "Back" 

LANGUAGE- "JavaScript " 
onmouseup- "window .navigate ( ' wa2 .htm' ) " 
> 

Back 

< /BUTTON > 

< BUTTON TYPE- "BUTTON" TITLE- "Next" 

LANGUAGE- "JavaScript" 
onmouseup- "window. navigate ( 'pop. htm* ) " 
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if* 



1.3 



Next 

</button> 

< /CENTER > 
<CENTBRxP> 

<HR WIDTH- " 100% "xBRx I x FONT SIZEa-l>f eelitQimmerse .com<BR> 
Copyright (c) 1996-1998, Immersion 
Corpora 1 1 on< / FONTx / I ></ Px /CENTER > 
</div> 

</body> 
</html> 



pop .htm — Ball popping demo, FIG. 13b 

< html >< head > 

«TITLE>Pop The Ball</TITLE> 

<atyle> .myStyle {" font- family i vecdana; color iwhite ) 
</otyle> 

<SCRIPT language«VBScript> 
//function wlndowonload ( ) 
// initialize!) 
//end function 
</SCRIPT> 

<SCRIPT FOR-window EVENT- "onload" LANGUAGE- "JavaScript " > 
document . onmousemove - compress; 

</SCR IPT> 

<SCRIPT language- N JavaScript "> 

var nerf ForcePlag - false; 
var nerf PoppedFlag • false; 
, var poppingPactor - 0.60; 
var theBallK - 10000; 
var previousY - 10000; 

function compress () ' 



{ 



var xval - event . clientX; 
var yval - event .clientY; 



// 

// Herf 
// 

if ( I nerf PoppedFlag ) 
{ 

// Check if we're touching the nerf 
if ( (xval > 
(nerfDiv.off setLeft+nerf Img.of f aetLeft) ) it 

(xval < 

(nerfDiv.of f setLeft+nerf Img.of fsetLef t+ner£ Img.of fsetWidth) ) 



) 



nerfDiv.of fsetTop) &£. 



{ 



if ( (yval > 
(yval < 



(nerfDiv.of fsetToptnerf Div.of faetHeight ) ) ) 

if ( (yval 

< nerfDiv.of faetTop+ (nerfDiv.of faetHeight / 3)) j| 
(previouaY < nerf Div.of CBetTop+(nerfDiv.oEfaetHeight / 3)) 

) 

{ // in 

start spring zone 

if ( I nerf ForcePlag ) 
( 

nerf ForcePlag - true; 

DynamicObject. SetSpringK{ theBallK ); 
DynamicObject . StartSpring ( event . screenY- 
(event . clientY-nerf Div . style. pixelTop) ); 
} 

} 

if ( 

nerf ForcePlag ) { 

if ( yval > 

(nerfDiv. of fsetTop* (nerf Div.of CsetHeight*poppingFactor) ) ) 
( 

PopSound .Run ( ) ; 
DynamicObject .BndSpring ( ) ; 

//DynamicObject .Pop ( ) ; 

nerf Img. style. height - (51) + "px°; // 51 - 

nerfpop.gif height 

nerf Img. Btyle. top » (nerfDiv .of f setHeight- (51 ) ) + 

"px"; 

// Change Image 
, nerf Img. src - "imagesWnerfpop.gif"; 
nerf PoppedFlag - true; 
nerf ForcePlag • false; 
) 

el Be 
{ 

nerf ling, style, top - (yval-nerf Div .of f oetTop) + 

"px"; 

nerf Img. style. height - 
(nerf Div.of fsetTop* nerf Div.of f setHeight -yval) 



"px" 
) 



else 

if ( yval >- 
(nerf Div.of faetTop+ner f Div.of f setHeight) ) 

( 

if ( 

nerf ForceFlag ) 

{ 

nerf Img. style. top - (nerf Dlv .of faetHeight -1) ♦> 



"px"; 



"px" ; 



nerf Img. style. height - 1 + "px"; 

else 
{ 

nerf Img. style. top - 0 + "px" ; 

nerf Img. style. height » nerfDiv.of f setHeight ♦ 

nerf ForcePlag - false; 
DynamicObject. EndSpringO ; 

) 

) 

else 
{ 



0 1- "px"; 

- nerfDiv.of f setHeight ♦ "px"; 



nerfForcePlag - false; 
DynamicObject . EndSpring ( ) ; 



nerf img. style. top - . 
nerf Img . style . height 
if ( nerfForcePlag ) 

I 



) 

nerf Img. style, width- «174px"; 



) 

previouaY - yval; 



function restoreBall () 
( 

BoingSound . Run ( ) ; 
// Change Image 

nerflmg.src « M images\\nerf .gifi " ; 
// Change Location and Size 
nerf Img. style. top - 0 * "px"; 
nerf Img. style .height - 
nerf Div.of faetHeight + "px"; 

nerf Img. style, width- *174px"; 
// Change Pop Flag 
nerf PoppedFlag » false; 



</ecript> 
</head> 

<body. 

bgcolor-ffffff 

> 

<BODY TEXT- "#000000" BGCOLOR- "BFFFFFF" LINK- ■ flFPOOOO" 

VLINK-"fl 8 00080" ALINK-"« 0000PF* 

BACKGROUND- " images \backgr ound . J pg" > 

cCENTER > < TABLE > 

<TR* 

<TDx/TDxTD> 

<CENTER>< IMG SRC-" images\logo2_red .gif " HEIGHT- 90 

W I DTH - 1 6 2 x / CENTER> 

</TDxTDx/TD> 

<TD> 

<CENTERxBxF0NT SIZB»+2>Pop The Ball</FONT></Bx/CENTER> 
</TD> <TD> </TD> 

<TDxIMO SRC- "images \moUSe.gif HEIGHT- 144 WIDTH-346x/TD> 

<TDx/TD> 

<./TR> 

< /TABLE* 

<CENTER> 

<HR WIDTH-»100%"xBR> 
</CENTER> 

<CENTERxDlV ID-DEBUG I NF0> </DIVx/CENTER> 

<0BJECT ID- "DynamicObject ■ WidtH-0 HBIGHT-0 

CLASS ID- "CLS ID i EC2 96 BEG - 836C- 11D1 - Afl 68 - 006008 3 A3 74 3" 

CODEBASE- "DynamicControl . CAfitf veraion-2 , 0, Q,0"> 

</0BJECT> . . 

<0BJECT ID- "PopSound" WIDTH-0 HEIGHT- 0 

CLASSID-"CLSIDi0558 9FAl-C35 6-llCB-BF0X-O0AAOO555 95A"> 
<PARAM NAME- "ShowCont role" VALUE- "G"> 
<PARAM NAME- •ShowDi splay" VALUE- b O"> 
<PARAM NAME- "AutoStart" VALUE-" 0"> 

< PARAM NAME* "AutoRe wind" VALUE- "X"> 
<PARAM NAME-"FlleName" 

VALUE-" sounds\pop3 .wav"> 
</OBJECT> 

. <0BJECT ID- "BoingSound" WIDTH-0 HEIGHT-0 
CLASSID«"CL3IDi05589PAl-C356-llCB-BF01-O0AA0O5S595A"> 
< PARAM NAME- 'ShowCont role" VALUE-" 0"> 

< PARAM NAME- "ShowDi splay" VALUE-" 0"> 
< PARAM NAMB-"AutoStart" 
< PARAM NAMS-"AutoRewind" 
< PARAM NAME- "Filename" 

VALUE- " sounds\bolng . wav" > 
</0BJECT> 



VALUE- "0"> 
VALUE-" 3. ■> 
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<div 

id-ner CDlv 

style- "position i absolute; lefti360/ top » 210; 
widuhi!74; heightil92/ overf lowiclip; " 
> 

<lmg id-nerClmg style- "posit ion i absolute; leftiO; 
topiO; t-indexi -l/" arc- " images\nerf .gif " > 
</div> 

<BUTTON TYPB-- BUTTON" TITLE- ■ Inflate Ball" 

STYLE- "position t absolute; lef 1 1 24 0; 

topi 290;" 

LANGUAGE** "JavaScript" 
onniouoeup-"reQtoreBall { ) " 
> 

Inflate Ball 
</BUTT0N> 

<div style-"po8itioniabsolute; lefttlO; topi440;* > 
<CENTER> 

< BUTTON TYPE- "BUTTON" TITLE- "Back" 

LANGUAQB- "JavaScript" 
onmouseup-" window. navigate t • spring, htm* ) " 
> 

Back 

</BUTT0N> 

<BUTTON TYPE- " BUTTON ■ TITLE- "Next " 

LANGUAGE- "JavaScript? 
onmouseup- "window. navigate ( ' ball. htm' ) " 
> 

Next » 

< /BUTTON > 

</CENTER> 

<CENTERxP> 

<HR WIDTH-"100*"xBRxIxFONT SIZE--l>f eelit®immeree.com<BR> 
Copyright (c) 1996-1998, Immersion 
Corpo ra t ion</ F0NT> </Ix/Px /CENTER> 
</div> 

</body> 
</html> 



ball.htm — Dynamic ball demo, FIG. 14 

<HTML> 
<HEAD> 

<META NAME- "GENERATOR" Content- "Microsoft Developer Studio"> 
<META HTTP -EQU IV- "Content -Type" conten t-" text /html; 
charset-iso-8859-1 "> 
<T I TLE> Bounce The Ball</TITLE> 

</HEAD> . ~ . 

<B0DY TEXT-"«000000" BGCOLOR-" 8 FFFFFF" LINK-»tfFFO000" 

VLINK-"#800080" ALINK-" ttOOOOFF" 

BACKGROUND- "images \background. jpg" > 

<CENTERxTABLB > 

<TR> 

<TDx/TD> 

<TD><CENTER>< IMG SRC- "image s\logo2 red.gif" HEIGHT- 90 

WIDTH- 162 ></CENTER> 

</TDxTDx/TDxTD> 

<CENTERxBxFONT SIZE» + 2>Bounce The Ball</FONTx/Bx /CENTER* 
</TDxTDx/TD> 

<TDx IMG SRC- "images\mouse.gif" HEIGHT- 14 4 WIDTH-246x/TD> 

<TDx/TD> 

</TR> 

</TABLExCBNTER> 

<HR WIDTH-"100%"xBR> 

</ CENTER > 

<!--<BODY style- "background- image i 

urHimages\BallBackground.jpg); background- repeat i no- 
repeat; *> 



< I - - Here are the images - 
<CENTERxDIV id* DEBUG INFO > 



:/DIVx/CENTER> 



VALUE- " 0 " > 
VALUE- "0" > 
VALUE- " 1 " > 



<OBJECT ID»"DynamicObject" WIDTH-0 HEIGHT-0 
CLASSID-"CLSIDiEC296EE6-B36C-llDl-Aa68-0060083A2742" 
CODEBASE- " DynamicCont rol . CAB If version- 2 , 0 , 0 . 0 ■ > 
«/OBJECT> 

<OBJECT ID«»Bonk6ound» NIDTH-0 HEIGHT-0 

CLASSID-»CLSIDiO5589FAl-C3S6-llCE-BFOl-0OAA0O555 9SA"» 

<PARAM NAME- "ShowCont vols" VALUE- "0"> 

<PARAM NAME- " ShowDlsplay * 

<PARAM NAME-"AutOStart" 

•cPARAM NAME- "AutoRewind" 

<PARAM NAME- -File Name" 
VALUE- ■ sounds \bonk . wa v "> 
</0BJECT> 

<IMG id-Courtlmg src- "images\court . jpg" style»"poaitioni 
absolute; topi 195 ; . lef 1 1 225 ; z-indext -1"> 
<IMG id*BalllItng area" lmages\ball.gif ■ 8tyle-"positlom 
absolute; topi 200; leftt230; z-indexi 1"> 
Balllmage Size is 100x100 --> 

<div Btyle-"poBition .absolute; lefttlOj topi535; n > 
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"JavaScript" 



<CENTBR> 

<BUTT0N TYPE- "BUTTON" TITLE- "Back" 

LANGU AG E- "JavaScript " 
onmouseup- "window .navigate ( 'pop. htm* ) " 
> 

Back 
/BUTTON > 

< BUTTON TYPE- "BUTTON TITLE- "Next" 

LANGUAGE- "JavaScript " 
onmouseup- "window. navigate ( ♦ demo.html ■ ) " 
> 

Next 

</BUTTON> 
< /CENTER > 
*P> 

<CENTERxHR WIDTH- ■ 100% "xBRx IxFONT SIZB- 
1 >f eel i trimmer se . com<BR> ' 
Copyright (c) 1996- 199B, Immersion 
Corpor at ion< / FONTx / 1 x/CENTER> 
</div> 

< SCRIPT FOR- window EVENT- "onload" LANGUAGE - 
// Initialize etart the ticker I 

document. onmousemove - doMouseMove; 

BalllRadius - 0.5 * Balll Img . of f setWidth; 

Ballllmg. style. height • Ballllmg. style .width; 

DynamicObject.StartBallO ; 

tick{) / 

«/SCRIPT> 

<SCRIPT language-JavaScript> 
var tickTimeout; 
tickTimeout - 1; 
var oldTime - new Dated ; 
var n - 0; 

var PlaygroundLef t, PlaygroundTop/ 

var PlaygroundWidth, PlaygroundHeight; , 

PlaygroundLef t - 230; 

PlaygroundTop - 200; 

PlaygroundWidth - 362;//390; 

PlaygroundHeight - 308///2 90; 

var BalllMass, BalllK; 

var BalllXp, BaillYp, BalllXpp, BalllYpp; 

BalllMass - 10; 

BalllK - 0.5; 

DalllXp -■ 0; 

BaillYp - 0; 

BalllXpp « 0; 

BalllYpp - 0; 

var ForceFlag; 
ForceFlag - false; 

// Periodically calls Itself 

function tick() 

{ 

moveBalla () ; 

window . setTimeout { " t ick ( ) ; " , tickTimeout , 
"JavaScript" ) ; 
} 

// Perform a Ball movement simulation 
function moveBalla <) 

// Calc dynamics for Balll during this time step 

BalllXp +- BalllXpp; 

BaillYp +- BalllYpp; 

Ballllmg. style. pixelLeft +- BalllXp; 

Ballllmg. style. pixelTop ♦- BaillYp; 

// WALL COLLISION DETECTION 

if ( Ballllmg. style. pixelLeft < PlaygroundLef t ) 
( 

BonkSound . Run ( } ; 

Balll Img. style. pixelLeft - 

PlaygroundLef t ; 

BalllXp - -BalllXp*0.75; 

} 

else 

if ( Ballllmg. style. pixelLeft > 
(PlaygroundLef t+ PlaygroundWidth) .) 
( 

BonkSound . Run ( ) ; 
Ballllmg. style. pixelLeft « 
(PlaygroundLef t+PlaygroundWidth) ; 

BalllXp - -BalllXp"0.75/ 

J 

if ( Balll Img. style. pixelTop < PlaygroundTop ) 
{ 

BonkSound . Run ( ) ; 

Ba 111 Img. style .pixelTop - PlaygroundTop; 
BaillYp - -BalllYp*0 .75 ; 

) 

else 

if { Ballllmg. style .pixelTop > 
(PlaygroundTop* PlaygroundHeight) ) 
{ 

BonkSound . Run ( ) ; 
Ballllmg. style. pixelTop «> 
(PlaygroundTop+ PlaygroundHeight) ; 

BaillYp - -BallIYp*0.75; 
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} 

// CalcLoopRateO; 
) 

function CalcLoopRateO 
{ 

var rate; 

n - n+1; 

if < n — 100 > 

( 

newTime » new OateO;. 
rate - newTime .getTimeO - 

oldTime .getTlme ( ) ; 

oldTime « newTime; 
// DEDUQIMFO. inner HTML « (1000/ { rate/n) ) ; 

n-0; 

) 

) 

// When the mouse moves, do bounds checking and possibly 
alter the Ball's X/Ypp function doMoueeKove ( ) 

_ var xc, yc, w, mag; 

// Ball 1 

xc » event .cllentX - 
(Dallllfng.of feetLeft+BalllRadiue) ; 

yc - event .clientY - (Ballllmg. off setTop 
♦ BalllRadiuG) ; 

w - xc*xc + yc*yc» 

// Are we Inside the Ball? 

if ( (w < (BalllRadius*BalllRadius) ) ) 

{ 

ForceFlag - true; 

mag- - ( (BalllRadlus/Math .sqrt (w) - 1) * 

BalllK) , 

DynamicObject .Apply Force ( xc, yc, 

maq*50000 ) ; 

BalllXpp - mag * xc / BalllMasg; 
BalllYpp - mag * yc / BalllMase; 

else 
{ 

// use the flag to prevent this from 
being called lots of times I 

if ( ForceFlag « true ) 
( 

// No, so- there will be no 

applied force 

BalllXpp - 0; 
BalllYpp - 0; 

DynamicObject .EndForce () ; . 
ForceFlag ■ false; 

} 

) 

var xabs, yabs; 

xabs - event. ocreenX - (event .off setX - 
Ballllmg. style .pixelLeft ); 

yabs - event .screenY - ( event .of f set Y - 
Ballllmg. style. pixelTop ); 

// DynamicObject .ChangeBallPoa ( xabs, yabs ); 

J 

</SCRIPT> 

</BODY> 
</l!TML> 



pendulum.htm — pendulum demo, FIG. 15 



< tDOCTYPE HTML • PUBLIC --//W3C//DTD HTML 3.2//EN"> 

<IITML> 

<HEAD> 

<TITLE>Cart - Pendulum FBELit Mouse Demonstration</T1TLE> 
</HEAD> 

<D0DY BGCOLOR- BLACK TEXT- RED* 

<DIV STYLE- -font -sine • 12 pt; £onfc - Cami ly . Verdana, Atrial, 
Helvetica"* 

<H3 ID-ntyHead>Cart- Pendulum Game < /II 3 > 
«/DlV> 

<CENTER><D1V i d« DEBUG lNFO> </DIV>< /CENTER > 
<HR> 

<OBJECT XD-6erra WIDTH-0 HBIGHT-0 

CLASSID«»CLSID.EC296EE6-B36C-11D1-A8 68-006008 3A274 2" 
CODEBASE- "Dynami cControl . CABfJ vers! on= 1 , 0, 0, l u > 
</0BJECT> 

<ODJECT ID-Cart 

STYLE* " Pos it ioni absolute; WIDTHt625; HEIGHT.425; toptlO; 
left t 70; Z- INDEX i 1" 

CLASSID-"CLSIDi3 69303C2-D7AC-lldQ-89D5-OOAOC9083 3B6" 
> 

< PAR AM NAME- •CoordinateSya tern" VALUE- "l *> 

< param NAMB-^MouseEventsEnabled" VALUE»-1*> 
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</OBJECT> 

<OBJECT ID- Pendulum 

6TYLE-"Positiontabeolute; WIDTHt625; HBIGHTi425; topilO; 
le£ti70/ Z-INDEXi 2" 

CLASS I D-" CLS I D i 3 6 93 03C2 - D7AC- 1 IdO - B 9D5 - 00A0C 906 3 3 E6 • > 

< PARAM NAMB-"CoDrdlnatoSystem" VALUE- "1 

< PARAM NAME« w MoueeEventaBnabled" VALUB-."1 

</OBJECT> 

<SCRIPT language«VBScript> 
function window_onloadO 

initialiseO 
end function 
</SCRIPT> 

<SCRIPT LANGUAGE- "Javascript »> 

var cartX, cartXp, cartXpp; 

var cartY, cartWidth, cartileight; 

var cartMaas; 

cartXpp » 0/ 

cartXp - 0; 

cartX - 300/ 

cartY - 200; 

cartwidth - 50; 

cartHeight - 30; 

cartMass - l; 

var cartK - 0.4; 

var forceFactor - 4000; 

var trackX, trackY, trackWidth, trackHeight; 
trackX - 0; 

trackY - cartHoight/2; 

trackWidth - Cart . style .pixelWidth; 

trackHeight - 10; 

var linkWidth, linklieight, plumbDiameter; 
linkWidth -10; 
linkLength - 100; 
plumbDiameter - 30; 

var pendT, pendTp, pendTpp; 

var pendMass, pendlnertia; 

pendT - 170; 

pendTp « 0; 

pendTpp - 0 ; 

pendMass » 1; 

pendlnertia ■ 1; 

var myOffsetX, myOffsetY; 
myOffsetX - 415; 
rayOffsetY - 250; 

var g - 9.81; 

var friction - 0.5; 

var forceX = 0; 

var forcePosMax - 50; 

var oldTime - new DateO ; 
var period; 

var lastHouseX - 0; 
var lastMouseY - 0; 
var buttonFlag - false; 
var forceFlag - false; 

var lib - Cart . Library ; // This sets up the 

Direct Animation Library for 

// DrawingSurface 

operations . 
// 

// Initialize our scripts 
function initializet) 
( 

CreateScene ( ) / 
TransformScene () ; 
tickO; 

) 

// TickO is performed every tick... 

function tickO 

i 

CalcLoopRateO ; 
Simulate O ; 
TransformScene () / 

window. setTimeout {• tick (); 1, "JavaScript" ); 

) 

// CalcLoopRate 

// Figure {t of seconds since last call to this function. 
// Stores value in global period, 

function CalcLoopRateO 
{ 

newTime - new DateO/ 

period - ( newTime. getTimeO - oldTime. getTlme () 

/ 1000; 

oldTime - newTime; 

period *- 2; // Scale to Integrate faster 

{make time flyl ) 
) 
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// Created the acene 
function CreateSceneO 
{ 

var dB; 

// Draw the cart and Track 
Ca rt . Eet Identity ( ) j 
da » Cart .DrawingSur face; 
// The Cart 

dB.FlllColor { lib. blue ); 
de.Rect( - (cartWidth/2) , - 
(cartHeight/2) . cartWidth, cartHeight ); 

// The Track 

da .FillColor ( lib. green ); 

da. Recti (trackX-300- (trackwidth/2) ) , 
trackY, trackWidth»3, trackHeight ); 

Cart .DcawingSurf ace - da; 

//Draw the linkage and plumb-bob 

da - Pendulum . DrawingSurf ace; 

// The Linkage 

da.PillColor(lib.ColorRgb255(255,0,0) ) ; 
da.Rect( - (linkWidth/2) , 0, linkwidth, 

linkLength ) ; 

// The plumb -bob 
da. FillColor (lib. ColorRgb255 (200, 200, 255) ) j 

da. Oval ( - (plumbDiameter/ 2) , 
(linkLength- (plumbDiame ter/2) ) , plumbDiameter, plumbDiameter 
)/ 

Pendulum. DrawingSurf ace - ds; 

// Trajnaform acene 
function TransformSceneO 
{ 

Cart .SetldentityO ; 

Cart .Translate ( cartX-myOff setX, cartY-myOf faetY, 



0 )/ 



myOffaetY 
) 



Pendulum. Set Identity ( ) / 
Pendulum. Rotate ( 0, 0. -pendT ); 
Pendulum. Translate ( cartX-myOf fsetX, 
, 0 ); 



// Performs dynamic simulation 

function Simulate () 

( 

var oldTRad - pendT* (Math. PI/1B0) ; 

var cosTRad - Math. cos (oldTRad) ; 
var ainTRad - Math. sin (oldTRad) ; 
var oldTpp pendTpp; 
var oldXpp - cartxpp; 

// Check interaction force 

if ( forceFlag ) . 

i / 

forceX - (lastMouseX - cartX) • cartK; 

DEBUGINFO. innerHTML- forceX; 

if ( forceX > forcePosMax } 

forceX - forcePosMax; 

else 

if ( forceX < -f orcePosMax) 

forceX - -forcePosMax; 



) 

elae 



forceX 



// Move the cart 

cartxpp - ( forceX - 
( pendMaa a * 1 inkLeng t h* oldTpp* coaTRad) ♦ 
(pendMass*linkLehgth*pendTp*pendTp*ainTRad) - 
(frict ion*cartXp) ) / (pendMasa+cartMasB ) ; 

cartXp cartXpp*period; 

cartX + » cartXp*period; 

if ( (cartX- (cartWidth/2) -103) < trackX ) 

• { 

cartX - trackX* (cartWidth/2) +103 ; 
cartxp - 0;//-cartXp; 
cartXpp ■ 0; 

) 

else 

if ( (cartX* (cartWidtb/2) -103) > 
(trackX+trackwidth) ) 
{ 

cartX - (trackX+trackwidth- 

(cartWidth/2) ) ♦103/ 

cartXp » 0///-cartxp; 
cartXpp m 0/ 

} 

// Move the pendulum 

pendTpp - - ( (g*sinTRad) ♦ (oldXpp*.cosTRad) ) / < 
(pendittertia/ (pendMasa* linkLength) ) + linkLength) » 

pendTp ♦ - pendTpp* period; 

pendT - (oldTRad + pendTp* period) * 
(180/Math.PI) j 

// DEBUGINFO. innerHTML- pendTpp + ■■ *** M + pendTp ♦ 

m u t oldTRad +«**»• + pendT ♦ " **• Pen" ♦ period; 

// Apply Force 

if ( forceFlag »- true ) 

{ 

Serra .ApplyPorce ( 1, 0. 
forceX* forceFactor ); 
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) 

else 



Serra .Apply Force ( 1, 0, 0 ); 



// DoMouseMove 

function doMouoeMove (button, clientX, clientY) 
{ 

if ( buttonFlag \ 

// if ( (clientY>(cartY-(cartHeight/2) +10) ) 

66 (clientY* (cartY* (cartHeight/2) +10) ) ) 



// 
// 
// 



( 



} 

else 



forcePlag « true; 
lastMouaeX - clientX; 



} 

else 



forceFlag - false; 
forceFlag - false; 



// doMoueeDown 

function doMouse Down (button, clientX, clientY) 
{ 

// Check if it* a the left mouse button 

if ( button mm i ) 

{ 

// Check if we're inside the box 
if ( (clientx>(cartx- (cartWidth/2) ) ) tt 
(clientX<(cartX+ (cartWidth/2) ) ) &t (clientY> (cartY- 
(cartlleight/2) )) fit (clientY< (cartY* (cartHeight/2) ) ) ) 

buttonFlag ■ true; 
forcePlag - true; 
lastMouseX - clientX; 

} 

) 

// doMouseUp 

function doMou a eUp (button, clientX, clientY ) 

// Check if it's the left mouse button 

if ( button — 1 ) 

{ 

buttonFlag « false; 
forceFlag - false; 

} } 
</SCRIPT> 

<SCR1PT FOR-Cart EVENT-onmouBedown {button, shift , x, y) 
LANGUAGE- "JScript"> 

// DEBUGINFO. innerHTML- • car* ; 

doMouaeDownt button ( x+ 70 -4 0, y+10-110+25) ; 

</SCRIPT> 

<SCRIPT POR-Cart EVENT-onmouaeup (button, shift. x,y) 

LANGUAGE. "JScript "> 

// debug INFO. inne r HTML- "car" / 

doMouaeUp (button, x + 70-4 0, y+ 10 -110+ 25 ) ; 

</SCRIPT> 

<SCRIPT FOR-Cart EVENT- onmousemove (button , eh if t , x, y ) 
LANGUAGE- ■ JScript ■ > 

// DEBUGINFO. innerHTML- "car"; 

doMouaeMove(button,x+7Q-40,y+l0-i:L0+2S) ; 

</SCRIPT> 

<SCRIPT FOR- Pendulum EVENT-onmouaedown (button, shift , x, y) 
LANGUAGE. "JScript "> 

// DEBUG INFO . innerHTML- "pen" ; 

doMoueeDown (but ton, x+7 0-40, y + 10 -1L 0*25) / 

</SCRIPT> 

<SCRIPT FOR- Pendulum EVENT- onmou a eup (button, shift, x,y) 
LANGUAGE- "JScript "> 

// DEBUQINFO . innerHTML- "pen" / 

doMoueeUp (button, x*70-40, y+ 10 -110+ 25) ; 

</SCRIPT> 

<SCRIPT FOR-Pendulum EVENT- onmou a emove (button, shift, x,y) 
LANGUAGE. -JScript "> 

// DEBUGINFO. innerHTML- "pen"; 

doMouoeMove (button, x+70 -40 , y+ 10 -11 0+25) ; 

</SCRIPT> 

<SCRIPT FOR- document EVENT-onmouaedown LANGUAGE- "JScript " > 
// DEBUG INFO. InnerHTML- "doc 11 ; 

doMouseDown( event .button, event .clientX+4 0 , 
event. clientY-70 ) ; 
«/SCRIPT> 

<SCRIPT FOR-document EVENT -onmouae up LANGUAGE- "JScript" > 
// DEBUG INFO . innerHTML- "doc" 

doMoueeUpt event .button, event . clientX* 40, 
event. clientY-70) ; 
</SCRIPT> 

<SCRIPT FOR-document EVENT-onmouaetnove LANGUAGE- "JScript " > 
// DEBUGINFO. innerHTML- "doc"; 

doMouseMove( event .clientY, event . clientX+40, 
event .clientY-70 ); 
</SCRIPT> 

<SCRIPT FOR-myHead EVENT- onmouae down LANGUAGE- "JScript" > 
tickt); 

</SCRIPT> 
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</BODY> 
</HTML> 



Remaining listings in Appendix C are used for 
all the demos in Appendix C 



DynamicControl. odl 

// DynamicControl.odl » ' type library source for ActiveX 
Control project. 

// This file will be processed by the Hake Type Library 
(mktyplib) tool to 

// produce the type library (DynamicControl . tlb) that will 
become a resource in DynamicControl .ocx . 

ft include <olectl .h> 
tl include <idlepida.h> 

[ uuid(EC296EB3-836C-ilDl-A868-00600B3A2742) , version( 1 . 0) , 
help£ lie ("DynamicControl .hip") , 

helpstring( 11 DynamicControl ActiveX Control module"), 

control ) 
library DYNAM I CCONTROLLib 
( 

importlib(STDOLS_TLB) / 
import lib (STDTYPE^TLB) / 

// Primary dispatch interface for 
CDynamicControlCtrl 

t uuid(EC296BE4-836C-llDl-AB68-0060083A2742> , 
helpstring( "Dispatch interface for 
DynamicControl Control") , hidden ] 

dlspinterf ace DDynamicControl 
{ 

properties « 

// MOTE - ClassWizard will maintain 
property information here. 

// Use extreme caution when editing 
this section. 4 

//{ {AFXJDDLPROP (CDynamicControlCtrl) 

//) }APX~ODL_PROP 

methods i 

// NOTE - ClausWicard will maintain 
method Information here. 

// use extreme caution when editing 

this section. 

// { { APX_0DL_METH0D (CDynamicControlCtrl ) 
lid(l)]~long ApplyForce ( long Xdir, long 

Ydir, long Mag)/ 

(id(2)J long EndForce ( > ,• 
[id (3)1 long StartBallO; 
lid (4) J long EndBallO / 

I id (5)] long ChangeBallPoa (long leftVal, 

long topVal) ; 

lid(6)] long StartSpringdong topVal) ; 
{id (7)] long EndSpringO; 
[id (8)1 long StartNerfOf 
lid {9} ) long EndNerfO; 
fid (10) ) long ChangeNerf Rect ( long left, 
long top, long width, long height) ; 

I id (11) J long SetSpringKdong theK) ; 
(id (12) ) long Pop() ; 
/ / } } AFX_ODL_METH0D 

lid(DISPID_ADOUTBOX) ) void AboutBox(), 



// Event dispatch interface for 
CDynamicControlCtrl 

I uuid(EC296BE5-836C-llDl-A868-O06O0B3A2742) . 
helpstringt "Event interface for DynamicControl 

Control") 1 

dlspinterf ace _DDynamicControlEvents 
( 

properties! 

// Event interface has no properties 

methods i 

// NOTE - ClaasWizard will maintain 
event information here; 

// Use extreme caution when editing 

thio section. 

//{ {AFX_ODL_BVENT (CDynamicControlCtrl) 
// } ) AFX_0DL_EVENT 

) ; 

// cIobo In format ion for CDynamicControlCtrl 

• I uuid(EC296BE6-B36C-llDl-AB68-0060083A2742) , 

helpstrlng ("DynamicControl Control") . controJ ) 
coclass DynamicControl 
. { 



[default) diopinterf oco 

^DDynamicControl ; 

(default, source) dispiuter f ace 
DDynamJ cControl Events; 

I; 

//{ {AFX_APPEND_0DL} } 
//} }AFX~APPEND~0DL} ) 



DynamicControl. inf 



(version) 

signa ture- " $CH ICAGO$ " 
AdvancedINF-2 . 0 
[Add -Code) 

DynamicControl . acx-Dynami cControl . ocx 
msvcr t . dl 1-mavcrt . dll 
rofc42.dll-mfc42.dll 
olepro32. dll»olepro32 .dll 
[DynamicControl .ocx] 

file-win3 2-x86-thi0cab 

cloid-{EC2 96EE6-83 6C-llDl-A868-0O6O083A274 2) 

FileVersion-l, 0,0, 1 

RegioterServer-yes 
(msvcrt.dll) 

PileVerelon-4, 20,0,6164 

hookomf c4 2 installer 
[mfc42.dll) 

FileVereion-4, 2, 0, 6256 

hook«mf c4 2 installer 
[olepro32.dll] 

FileVereion-4, 2,0, 6068 

hook«mf c42iimtaller 
[mf c42installer] 

flle-win32- 

x0 6* ht tp i //activex . microsoft . com/control s/vc/mf c4 2 . cab 
run- % EXTRACTED I R*\raf c42 .exe 



DynamicControl.def 

; DynamicControl.def i Declares the module parameters. 



" DYNAM I CCONTROL . OCX » 



DllCanUnloadHow ©1 PRIVATE 

DllGetClaasObject 92 PRIVATE 

DllRegisterServer ®3 PRIVATE 

DllUnregieterServer «4 PRIVATE 



DynamicControl.rc 



//Microsoft Developer Studio generated resource script. 
// 

flinclude "resource .h" 

fldefine APSTUDIO_READONLY SYMBOLS 

/////////////////////////7//// //////////////// ///////////// 

.// 

// Generated from the TEXT I NCLUDE 2 resource. 
// 

llinclude "afxres.h" 

//////////////////////////////////////////////////////////// 
Uundef APSTUDIO_READONLY_SYMBOLS 

//////////////////////////////////////////////////////////// 
// English (U.S.) resources 

flif (defined (AFX_RESOURCE_DLL) || defined (AFX_TARG_ENU) 
ttifdef WIN32 

LANGUAGE LANG_ENGL I SH , SUBLANG_ENGLISH_US 
flpragma code_page(1252) 
flendif //_WIN32 

ttifdef APSTUDIO_INVOKED 

/////////////////////////////////////////////////////////// 
// 

// TEXT I NCLUDE 
// 

1 TEXT I NCLUDE DISCARDABLE 
BEGIN 

"resource .lAO" 

END 

2 TEXT INCLUDE DISCARDABLE 
BEGIN 

"Sinclude " "afxres .h" »\r\n" 



"\0" 



END 



3 TEXT INCLUDE DISCARDABLE 
BEGIN 

"1 TYPELIB • "DynamicControl. tlb?" \r\n" 
"NO- 
END 



.Docket No. IMMIP062 



-81 - 




(I end if 



// APSTUDIO_INVOKBD 



tan? 



ly 
u 



m 



hi 

LV 

1.11 



flifndef _MAC 

/////////////////////////////////////////////////////////// 
It 

il Veroion 

VS_VBRSION_INFO VERS I ON INFO 

FILEVBR8ION 2,0,0,0 

PRODUCTVBRSION 2,0,0,0 

PILE FLAGSMA SK 0x3 fL 
flifdef _DEBUG 

PILE FLAGS OxlL 
Helee 

FILE FLAGS OxOL 

8endif 

PILEOS 0x4L 
PILETYPE 0x2L 
PILESUBTYPE OxOL 
BEGIN 

BLOCK "StringFilelnfo" 
BEGIN 

BLOCK "040904b0« 

BEGIN 

VALUE "Company Name" , "Immersion Corporation\0" 
VALUE "PileDeacriptionr, "DynamlcControl ActiveX 

Control Module\0" 

VALUE "Pilevereion", -2, 0, 0, 0\0- 
VALUB " Interna lName", " D YNAM I CCONTROL\ o ■ 
VALUE "LegalCopy right*. -Copyright (C) 199B\0» 
VALUE "Original Filename*. " DYN AM I CCONTROL . OCX \ 0 ** 
VALUE "Product Name" , "DynamlcControl ActiveX 

Control Module\0« 

VALUE "Product Vers ion«, "2, 0, 0, 0\0" 

END 

END 

BLOCK "VarPilelnfo'' 
BEGIN 

VALUE "Translation", 0x409, 1200 

END 

END 



ilendif 



// l_MAC 



//////////////////////////////////////////■///////////////// 
// Icon 

// Icon with lowest ID value placed first to ensure 
application icon 

// remains consistent on all systems. 
IDIABOUTDLL ICON DISCARDABLE 

■DynamlcControl. ico" 

7////////////////////////////////////////////////////////// 
// Bitmap 

I DB_DYNAM I CCONTROL BITMAP DISCARDABLE 

"DynatnicControlCtl. bmp" 

/////////////////////////////////////////////////////////// 
// Dialog 

I DD_ABOUTBOX_D¥NAM I CCONTROL DIALOG DISCARDABLE 34. 22, 260, 
55 

STYLE DS_MODALFRAME j WS_POPUP | WS_CAPT!ON | WS_SYSMENU 
CAPTION "About DynamlcControl Control" 
PONT 8, "MS Sans Serif" 
BEGIN 

ICON IDI ABOUTDLL, IDC_STATIC, 10,10, 2 0, 2 0 

LTEXT "DynamicControl Control, Version 

1.0", IDC_STATIC. 40, 10. 

170,8 

LTEXT "Copyright (C) 1998, Immersion 

Corporation". I DC STATIC. 

40,25,170,8 

DEFPUSH BUTTON "OK", IDOK.221.7, 32 , 14 , WS_GROUP 

END 

I DD_PROP£>AGE_D YNAM I CCONTROL DIALOG DISCARDABLE 0, 0, 250, 
62 

STYLE WS_CHILD 

PONT a, "MS Sans Serif" 

BEGIN 

LTEXT "TODOi Place controls to manipulate 

properties o£ DynamlcControl Control on this dialog,", 
IDC_STATIC, 7, 25, 229, 16 

END 

/////////////////////////////////////////////////////////// 

// DESIGNINFO 

ftifdef APSTUDIO_ INVOKED 

GUIDELINES DESIGNINFO DISCARDABLE 

BEGIN 

IDD_ABOUTB0X DYNAMICCONTROL, DIALOG 
BEGIN 

LEFTMARGIN, 7 ' 
RIGHTMARGIN, 253 
T0PMARGIN, 7 
BOTTOMMARG I N , 48 

END 

I DD PROP PAGE DYNAMICCONTROL, DIALOG 

begTn 

lbptmaroin. 7 

RIGH1WARCIN, 24 3 
TOPMARGIN. 7 



BOTTOMMARG IN, 55 



END 

END 
ffendif 



// APSTUD I 0_ INVOKED 



/////////////////////////////////////////////////////////// 

// String Table 
STRINGTABLE DISCARDABLE 
BEGIN 

IDS DYNAMICCONTROL 



"DynamicControl Control" 



IDS_DYNAMlCCONTROL_PPG "DynamlcControl Property Page" 
END 

STRINGTABLE DISCARDABLE 
BEGIN 

IDS_DYNAMICCONTROL_PPG_CAPTION "General" 

END 

Ilendif // English (U.S.) resources 

/////////////////////////////////////////////////////////// 
flifndef APSTUDIO__INVOKED 

//////////////////////////////////////////////////////////// 

// Generated from the TB XT I NCLUDE 3 resource. 

// 

1 TYPELIB "DynamlcControl. tlb" 

//////////////////////////////////////////////////////////// 
flendif // not APSTUDIO_INVOKED 



DynamicControl.h 

Bif 

Idef ined(AFX_DYNAMlCCONTROL_II EC2 96EEC_836C_11D1_A868_00600 

8 3A274 2 I NCLUDE D_) 

ffdefine 

AFX_DYNAMICCONTROL_H EC296EEC_83 6C_llDl_A86B_O06O0B3A2742 : 

INCLUDED_ 

flif _MSC_VER >» 10O0 
flpragma once 

flendif // _MSC_VER >- 1000 

// DynamicControl.h i main header file for 
DYNAMICCONTROL . DLL 

flif ldefined{ _AFXCTL_H J 

(terror include 'afxctl.h* before including this 

file 
tfendif 



{(include "resource. h" 



// main symbols 



/////////////////////////////////////////////////////////// 
// CDynamicControlApp i See DynamlcControl . cpp for 
implementation. 

class CDynamicControlApp t public COleControlModule 
{ 

public i 



BOOL Initlnstance () ; 
int Exit Instance () ; 



extern const GUID CDECL _tlid/- 
extern const WORD _wVerMajor; 
extern const WORD _wVerMinor/ 

// { {AFX_INSERT_LOCATION} ) 

// Microsoft Developer studio will insert additional 
declarations immediately before the previous line. 

«endif // 

I defined (AFX D YNAM I CCONTROL_H EC2 96EBC_836C_1 1D1_AB6B_00600 

83A2742 INCLUDED) 



DynamicControl.cpp 

// DynamicControl.cpp t Implementation of CDynamicControlApp 
and DLL registration. 

flinclude "stdafx.h" 
{(include "DynamicControl.h" 

flifdef __DBBUG 
Hdefine~new DEBUG_NEW 
Sundef THIS_FILB 

Btatic char THIS_FILEH - PILE 

ftendif 

CDynamicControlApp NEAR theApp/ 

const GUID CDECL BASED_CODE _tlid - 

( 0xec296ee3, 0x836c, Oxlldl, ( 0xa8. 
0x68, 0, 0x60, 0x8, 0x3a, 0x27, 0x42 ) ); 
conBt WORD _wVerMajor - 1 
const WORD wVerMinor - 0; 
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* 



# 



In 

b 



/////////////////////////////////////////////////////////// 

// CDynamicControlAppi 1 1 nit Instance - DLL initialization 

BOOL CDynamicControlAppi i Init Instance ( ) 
{ 

BOOL blnit - COleControlModule ■ i Init Instance () / 

if (blnit) 
{ 

// TODOi Add your own module 
initialization code here.' 
) 

return blnit; 

) 

///////////////////'/////////////////////////////////////// 
// CDynamicControlApp t ■ Exit instance - DLL termination 

int CDynamicControlAppi i Exit Instance () 



// TODOi Add your own module termination code 
return COleControlModule i tExit Instance () ; 



{ 

here. 
) 

////////////////////////////////////////////////////////// 
// DllRegisterServer - Adds entries to the system registry 

STDAPI DllRegisterServer (void) 
( 

AFX^MANAG B_STATB < _a f xM odu 1 e Add r Th i fl ) ; 

i f ( I AfxOleRegieterTypeLib ( Af xGet Instancellandle ( ) , 

_tlid)) . 

return 

Result FroinScode (SELFRBG E_TYPELIB) ; 

if ( ICOleObjectFactoryEx. lUpdateRegistryAll (TRUE) ) 
return ResultFromScode (SBLFREQ_E_CLASS) ; 
return NOBRROR; 

) 

//////////////////y//y///////////////////// /////////////// 

// )DllUnregisterServer - Removes entries from the system 
registry 

STDAPI DllUnregiBterServer (void) 
{ 

AFX_MANAGB__STATE <_af xModuleAddrTh is ) ; 

if ( !Afx01eUnregisterTypeLib{_tlid, _wVerMajor, 
_wVerMinor) ) 

return 

ReeultFromScode(SELFREO_BjrYPELIB) ; . 
if 

( ICOleObjectFactoryEx i lUpdateRegia tryAll (FALSE) ) 

return ResultFromScode (SELPREG_E_CLASS) ; 

return NO ERROR; 



DynamicControlCtl.h 

«if 

I defined <AFX_DVNAMICCONTROLCTL_H EC296EF4_836C_11D1_A868_0 0 

60083 A2742 INCLUDED) 

((define 

AFX_DVNAMICCONTROLCTL_H EC296EF4_836C_11D1_AB68 J)0600B3A274 

2 INCLUDED_ 

((if _MSC_VBR >- 100 0 
H pragma once 

flendif // _MSC_VER >- 1000 

// DynamicControlCtl.h • Declaration of the 
CDynamicControlCtrl ActiveX Control class. 

////////////////////////////////////////////////////////// 
// CDynamicControlCtrl « See DynamicConcrolCtl .cpp for 
implementation. 

claoo CDynamicControlCtrl i public COleControl 
{ 

DECLARE_DVN CREATE (CDynamicControlCtrl ) 

// Constructor 
public i 

CDynamicControlCtrl () ; 

// Overrides 

// ClaaBWizard generated virtual function 

overrides 

// { { AFXJV IRTUAI. (CDynamicControlCtrl ) 
pub lie i 

virtual void OnDraw(CDC* pdc, const CRectfi 
rcBounds, const CRectfe rclnvalid); 

virtual void DoPropBxchange (CPropExchange* pPX) ; 
virtual void OnReoetState ( ) / 
virtual DWORD GetCont col Flags () ; 
//} )afx_virtual 



// Implementation 
protected! 

-CDynamicControlCt rl ( ) ; 

DECLARE_OLECREATE_BX (CDynamicControlCtrl) // 
Class factory and guid 

DECLARE_OLBTYPBLIB (CDynamicControlCtrl) // 
GetTypelnfo 

DECLARE_PR0PPAGB1DS (CDynamicControlCtrl) // 
Property page IDs 

DECLARE_OLECFLTYPB (CDynamicControlCtrl) 
// Type name and tnisc status 

// Message maps 

// { { AFX_MSG (CDynamicControlCtrl ) 

// MOTE - ClaBsWizard will add and 
remove member functions here. 

// DO NOT EDIT what you see in these 
blocks of generated code I 
//) )AFX MSG 
DECLARE~MESSAGE_MAP ( ) 

// Dispatch maps 

//{ |AFX_DISPATCH (CDynamicControlCtrl ) 
afxjnsg long ApplyForce (long Xdir, long Ydir, long 



Mag) ; 



topVal) ; 



afx_msg long EndForceO; 
afx_meg long StartBalK); 
afx_msg long EndBallO; 

afxjnag long ChangeBallPos (long leftval, long 



a£x_msg long StartSpring (long topVal) / 
afx_msg long EndSpringO; 
afx_mog long StartNerfO; 
afx~msg long EndNerfO; 

afx_msg long ChangeNerf Rect (long left, long top, 
long width, long height) ; 

afx_msg long SetSpringK ( long theK) ; 
af x_msg long Pop ( ) ; 
/ / } Jafx_di S PATCH 

DECLARE_DI S PATCH_MAP ( ) 

afx_mBg void AboutBox() ; 

// Event maps 

//{{AFX EVENT(CDynamicControlCtrl) 
//} )AFX~EVENT 
DECLARE_EVENT_MAP ( ) 

// Dispatch and event IDs 
public t 

enum { 

//{ {AFX_DISP_ID (CDynamicControlCtrl) 
dispidApplyForce » 1L, 
dispidEndForce - 3L, 
dispidStartBall - 3L, 
diBpidEndBall - 4L, 
dispidChangeBallPos - 5L, 
diBpidStartSpring » 6L, 
dispidEndSpring - 7L, 
diepidStartNerf - 8L, 
dispidEndNerf - 9L, 
dispidChangeNerf Rect - 10L, 
diBpidSetSpringK « 11L, 
dispidPop - 12L, 
//})APX DISP ID 

); 

>> 

// { { AFX_IHSERT_LOCATION) } 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. 

flendif // 

! defined (AFX_DYNAMICCOHTROLCTL_H EC296EP4_836C_11D1_A86B_00 

60083A2742 INCLUDED) 



DynamicControlCtl.cpp 

// DynamicControlCtl.cpp t implementation of the 
CDynamicControlCtrl ActiveX Control class. 

((include "stdafx.h" 

((include <objaafe.h> 

((include <comcat.h> 

((include "DynamicControl .h" 

((include "DynamicControlCtl.h" 

((include •DynamicControlPpg .h n 

(I include "DynamicPorces . h" 

HRESULT CreateComponentCategory ( CAT ID cat id, WCHAR* 
catDescript ion ) ; 

HRESULT RegiuteiCLSIDInCategory ( HBPCLSID els Id. CAT ID cat id 
it 

HRESULT UnregisterCLSIDInCategory( REFCLSID clsid, CAT ID 
cat id ) ; 

(JifdeE DEBUG 
((define new DEBUG_NBW 
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fluildef THr3_FILE 

utatlc char~VHIS F ILE J J - PILE , 

Hendif 

IMl'LEMENT^DYNCREATE (CDynamicCont rolCtrl , COleCont rol ) 

////////////////////////////////////////////////////////// 
// Message map 

BEGIN_MESSAGE MAP (CDynamlcControlCtrl, COleCont rol) 
//(TaFX_MSG_MAP (CDynamlcControlCtrl) 
// NOTE - ClassWizard will add and remove message 

map entries 

// DO HOT EDIT what you Bee in these blocks of 
generated code I 

//) }AFX_MSG_MAP 

ON_0LBVERB(AFX_IDS_VBRB_EDIT. OnEdit) 
ON_0LEVERB(AFX~IDS_VBRB_PR0PERTIBS, OnPropert ies) 
EH0J4ESSAGEJ4APO 

/////////////////////////////////////////////////////////// 
// Dispatch map 

BEGIN DISPATCH_MAP (CDynamlcControlCtrl, COleCont rol J 

//{ {AFX_DISPATCH_MAP (CDynamlcControlCtrl) 

DISP_PimCTION (CDynamlcControlCtrl , "Apply Force " , 
ApplyForce, VT_I4, VTS 14 VTS_I4 VTS_I4) 

DISP FUNCTION (CDynamlcControlCtrl, "EndForce", 
EndForce, VT_I4. VTS_NONE) 

DISP_FUNCTION (CDynamlcControlCtrl, "BtartBall" , 
StartBall. VT_I4, VTS_NONE) 

D1Sp\_FUNCTI ON (CDynamicCont rol Ctrl, "EndBall", 
EndBall. VT I 4? VTS HONE) 

DISP_FUNCTION (CDynamlcControlCtrl, 
■ Change Bail Poo", ChangeBallPos, VT_I4, VTS_I4 VTS_I4) 

DISP_FUNCTION (CDynamicCont rolCtrl , "StartSpring" , 
StartSpring, VT_I4, VTS_I4) 

DISP_FUNCTI0N7cDynamlcCont rolCtrl, "EndSpring" , 
EndSpring. VT_I4, VTS_NOHB) 

DISP_FUNCTION (CDynamlcControlCtrl, "StartNerf 
StartNerf, VT 14, VTS NONE) 

DISP_FUNCTION (CDynamlcControlCtrl, "EndNerf", 
EndNerf, vt 14, vts nonb) 

DISP_FlJNCTION (CDynamlcControlCtrl, 
"ChangeNerfRecf. ChangeNerf Rect, VT_I4, VTS_I4 VTS_I4 
VTS_I4 VTSI4) 

DISP_FUNCTlON{CDynamicControlCtrl, "SetSpringK" , 
SetSpringK, VT_I4, VTS_I4) 

DISP_FUNCTION (CDynamlcControlCtrl. "Pop", Pop, 
VT_I4, VTS NONE) 

//} }AFX_DiSPATCH_MAP 

DISP_FUNCTION_ID7cDynamicControlCtrl, "AboutBox" , 
DISPID ABOUTBOX, AboutBox, VT_EMPTY. VTS_NONE) 
END_D1SPATCH_MAP ( ) 

/////////////////////////////////////////////////////////// 
// Event map 

BEGIN_EVBNT_MAP (CDynamicCont rolCtrl, COleCont rol) 
// { { AFX_EVENT_MAP (CDynamicCont rolCt r 1 ) 
// NOTE - ClassWizard will add and remove event 

map entries 

// DO HOT EDIT what you see in these blocks of 
generated code I 

//) )AFX_EVENT MAP 
END_EVENT_MAP ( ) 

/////////////////////////////////////////////////////////// 
// Property pages 

// TODO. Add more property pages as needed. Remember to 
increase the count! 

BEGIN_PROPPAGEIDS (CDynamlcControlCtrl , 1) 

PROPPAGEID(CDynamicControlPropPaget iguid) 
END_PROPPAGE I DS (CDynamicCont rolCtrl ) 

////////////////////////////////////////////////////////// 
// Initialize class factory and guid - 
IMPLEMENT_OLECREATE_EX (CDynamicCont rolCtrl , 
"DYNAMICCONTROL.DynamicCont rolCtrl . 1" , 

0xec296ee6. 0x835c, Oxlldl, OxaB , 0x68, 0, 0x60, 
0x8, 0x3a, 0x27, 0x42) 

/////////////////////////////////////////////////////////// 
// Type library ID and version 

IMPLEMENT_OLETYPBLIB (CDynamicCont rolCtrl, _tlid, _wVerMajor, 
_wVerMinor) 

/////////////////////////////////////////////////////////// 
// Interface IDs 

conat IID BASED_CODE . I ID_DDynamicControl » 

{ 0xec296ee4, QxB36c, Oxlldl, { OxaS, 0x68, 0, 
0x60. OxB, 0x3a, 0x27, 0x42 } ); 

const I ID BASED_CODE 1 lD_DDynamicControlEvents » 

{ 0xec296ee5, 0x836c, Oxlldl, { OxaS, 0x68. 0, 
0x60, 0x8, 0x3a. 0x27, 0x42 } ); 

/////////////////////////////////////////////////////////// 
// Control type information 

static const DWORD BASED_CODB dwDynamlcCont rolOleMiac » 
OLEHISC INVIStHLKATRUNTlME | 
O LEM 1 SC~S ETCL I ENTS I TE F I RST | 
OLEMISC INSIDEOUT | 
OLEM19C~CANTLINKINSlDE j 
OLEMISC_RECOMPOSEONRESiaE; 
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lMPLEMBNT_OLECTLTYPE (CDynamicCont rolCtrl . 

I DS_D YH AM I CCONTROL , _dw Dy n ami cCon C r olO 1 e M i s c ) 

//////////////////////////////////////////////////■//////// 
CDynamlcControlCtrl » « CDynamicCont rolCtrl Facto ryi tUpdateRegis 
try - 

// Adds or removes system registry entries for 
CDynamicControlCt rl 

BOOL 

CDynamicControlCt rl « i CDynamicCont rolCtrl Factory i tUpdateRegis 

try (BOOL bRegister) 

{ 

// TODO i Verify that your control, follows 
apartment -model threading rules. 

// Refer to MFC TechNote 64 for more information. 

// If your control does not conform to the 
apartment-model ruleB, then 

// you must modify the code below, changing the 
6th parameter from 

// af xReglnaertable J af xRegApartmentThreading to 
afxfieglnaertable. ' 

if (bRegister) 
{ 

Create Component Category ( CAT 1 Decontrol . 

L^Controls" )/ 
Regis terCLSIDInCategory ( tn_clsid, 

CAT I Decontrol ) i 

CreateComponentCategory ( 
CATID_SafeFor Initializing, 

L"ControlB safely initial izable from persistent 

data" ) 

RegisterCLSXDinCategory ( m__clsid, 
CATIDSafe For Initializing ); 

CreateComponentCategory { 
CAT I D_Safe For Scrip ting, 

L"ControlB that are safely scriptable* )j. 

Regis terCLSIDInCategory { tn_clsid, 
CATID_SafeForScripting ); 

CreateComponentCategory! 
CATID_PersistBToPropertyBag, 

L"Support initialize via PersistPropertyBag" ) f 
Regis terCLSIDInCategory ( m_claid, 
CATID_PeraistsToPropertyBag ) ; 

return AfxOleRegisterControlClass ( 
AfxGetlnstanceHandleO , 
m_clsid, 
m_lpszProgID, 
I DS__DYNAM I CCONTROL , 
lDB_DYNAMICCOHTROL, 
. af xReglnaertable | 

afxRegApartmentThreading, 

_dwDynamicControl01eMisc, 

_wVer Major, 
wVerMinor) ; 

} 

else 
( 

Un regie terCLSIDInCategory ( m_clsid, 

CATI Decontrol ) / 

UnreglsterCLSIDInCategory < m_clBld, 
CATID_PerelstsToPropertyBag ); 

UnreglsterCLSIDInCategory ( tn_claid, 
CATID_SafeForScripting ) ; 

UnreglsterCLSIDInCategory ( m_cleid, 
CATIDjSafeForlnitializing ) ; 

return AfxOleUnregisterClass (m_cleid, 

m_lpezProglD) ; 

) 

} 

/////////////////////////////////////////////////////////// 
// CDynamlcControlCtrl i » CDynamlcControlCtrl - Constructor 

CDynamlcControlCtrl i t CDynamlcControlCtrl ( ) 
{ 

InitializeIIDB(liIID_DDynamicControl, 
&IID_DDynamicControlEventB) / 

// TODO i Initialize your control's instance data 

here . 

FeelSetup ( AfxGetlnstanceHandle () , 
AfxGetMainWnd () ->ro hWnd ) ; 

)" . 

////////////////////////////////////////////.////////////// 
// CDynamlcControlCtrl » i -CDynamlcControlCtrl - Destructor 

CDynamlcControlCtrl » * -CDynamlcControlCtrl ( ) 
{ 

// TODO* Cleanup your control's instance data 

here . 

FeelCleanupi ) ; 

} 

//////////////////////////////////////////////////////>/// 
// CDynamicCont rolCtrl • i OnDraw - Drawing function 
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void CDynamicControlCtrlt iOnbraw( 

CDC* pdc, const CRectfc rcBounde, const 

CRect& rclnvaltd) 
( 

// TODOi Replace the following code with your own 
drawing code. 

pdc->PillRect (rcBounds, 
CBrushi iFromHandle( (HBRUSh)GetStockObject ( WHITE J9RUSH) ) ) ; 

pdc- >Ellipse (rcBounds) ; 

/////////////////////////////////////////////////////////// 
// CDynamicControlCtrl! i DoPropExchange - Persistence support 

void CDynamicControlCtrl i t DoPropExchange (CPropExchange* pPXJ 
{ 

ExchangeVersion (pPX, MAKBLONO (_wVerMinor . 
jtfVerMajor) ) ; 

COleControl t i DoPropExchange (pPX) ; 
■ // TODOi Call PX__ functions tor each persistent 
custom property. 

) 

/////////////////////////////////////////////////////////// 
// CDynamicControlCtrl i iGetControlPlags - 
// Plags to customize MPC'e implementation of ActiveX 
controls . 

// , 

// For information on using these flags, please see MFC 
technical note 

// flnnn. "Optimizing an ActiveX Control". 
DWORD CDynamicControlCtrl i iGetCont r 61 Flags () 
I 

DWORD dwFlags - COleControl i tGetControlPlags () ; 



// The control can activate without creating a 

window . 

// TODOi when welting the control's message 
handlers, avoid using 

// the m_hWnd member variable without first 

checking that its value is non-NULL. 

dwFlags |- windowlessActivate; 

return dwFlags ; 

) 

/////////////////////////////////////////////////////////// 
// CDynamicControlCtrl i tOnResetState - Reset control to 
default state 

void CDynamicControlCtrl i lOnReBetStateO 
( 

COleControluOnResetStateO ; // Resets defaults 
found in DoPropExchange 

// TODOt Reset any other control state here. 

) ■ 

/////////////////////////////////////////////////////////// 
// CDynamicControlCtrl • .About Box - Display an "About" box to 
the user 

void CDynamicControlCtrl! iAboutBox() 



{ 



CDialog dig About ( I DD_ABOUTBOX_DYNAM ICCOHTROL) ; 
dig About .DoModal () ; 



/////////////////////////////////////////////////////////// 
// CDynamicControlCtrl message handlers 

long CDynamicControlCtrl i i Apply Force { long Xdir, long Ydir, 

long Mag) 

{ 

return FeelBeginForce ( Xdir, Ydir. Mag ); 

I 

long CDynamicControlCtrlt iBndForceO 
( 

return FeelEndForceO ; 



H RESULT CreateComponentCategory( CAT I D cat id, WCHAR* 

catDeectript ion ) 

( 

ICatRegister* per - NULL; 

H RESULT hr - S_OIC, 

// Create an instance of the category manager 

hr - CoCreateTnstance ( 

CLS I D_S t dCompon e ntCategorieaMgr, 

NULL. 

CLSCTX_INPROC_SERVER, 
I ID_ICatRegister, 
(void**) ftpcr 
it 

it { FAILED (hr) ) 

return hr; 

CATEGORY INFO cat info ; 
catinfo.catid - catid; 

catinCo.lcid > 0x0409; // English locale ID in hex 



) 



int len - wcslent catDeocr iption )j 

wesncpyf catinfo. szDeecr iption, cat Deacr iption , 

catinfo.szDescription{len| - '\0'; 

hr - per- >RegioterCategories ( 1, dcatihfo ); 

pcr->Release () ; 

return hr; 



URESULT RegieterCLSlDlnCategory (REFCLSID clsid, CATID catid) 
{ 

ICatRegister* per - NULL; 
((RESULT hr - SJ3K; 

// Create an instance of the category manager 
hr » CoCreatelnstance ( 

CLSID_S tdComponentCa tegor iesMgr , 

NULL," 

CLSCTX_INPROC_SERVBR, 
IID_lCatRegister, 
(void**) &pcr 

)i 

i£ (SUCCEEDED (hr) ) 
{ ■ 

CATID rgcatidtl] ; 
rgcatid[0] - catid; 

hr - pcr->ReglsterClasBlmplCategories( 

clsid, .1, rgcatid ) ; 
} 

if ( per 1- NULL ) 

per- >Release () ; 

return hr; 

} 

HRBSULT UnregisterCLSIDInCategory ( REFCLSID clsid, CATID 

catid ) 

{ 

iCatRegister* per - NULL; 
HRESULT hr - S_OK; 

// Create an instance of the category manager 
hr « CoCreatelnatance( 

CLS I D_StdCompone ntCategorieaMgr, 

NULL, 

CLSCTX_INPROC_SERVER, 
I lD_ICat Register, 
(void**) &pcr 

); 

If. (SUCCEEDBD(hr) ) 
{ 

CATID rgcatid [1) ; 
rgcatidlo] - catid; 

hr « pcr->UnRegisterClassImplCategories ( 

clsid, 1, rgcatid ) ; 
) 

if ( per I- NULL ) 

pcr->Release () ; 

return hr; 

} ' 

long CDynamicControlCtrl} iStartBall () 
{ 

return FeelBeginBall ( ) ; 

) 

long CDynamicControlCtrl! lEndSallO 
{ 

) 

long CDynamicControlCtrl i iChangeBallPos ( long leftVal, long 

topval) 

{ 

return FeelChangeBallLocation( leftVal, topval ); 

} 

long CDynamicControlCtrl! iStartSpring ( long topVal) 



return FeelEndBall ( ) / 



return PeelBeginSpring ( topVal ); 



t 
) 

long CDynamicControlCtrl! iEndSpring() 
{ 



return FeelEndSpring ( ) ; 



long CDynamicControlCtrl i iStartNerf () 



return FeelBeginNerf () ; 



long CDynamicControlCtrl! lEndNerf () 
{ 

return FeelEndNerf () ; 

} 

long CDynamicControlCtrl i i ChangeNerf Rect (long left, long 

top, long width, long height) 

{ 

return FeelChangeNerf Rect ( left, top, width, 

height ) ; . 
} 

long CDynamicControlCtrl i iSetSpringK (long theK) 



return FeelSetSpring ( theK ); 



long CDynamicControlCtrlt iPopO 
{ 

return FeelPopO; 

} 
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DynamicControlPpg.h 

Hit 

l de £ ined < AFX__DYNAM ICCONTROLPPG_H EC296EF6_836C_11D1_AB6 8_00 

60083A2 74 2 TnCLUDBD_) 

Bdefine 

AFXJJYNAMICCONTROLPPG ll_^EC2 96EF6 836C 11D1_A868_0060083A274 

2__7ncluded_ 

HiC J4SC_VER >. 1000 
(I pragma once 

Hendif // _MSC_VER >- 1000 

// DynamicControlPpg.h i Declaration of the 
CDynamicControlPropPage property page class. 

////////////////////////////////////////////////////////// 
// CDynamicControlPropPage t See DynamicControlPpg . epp . epp 
for implementation. 

claBB CDynamicControlPropPage i public COlePropertyPage 
( 

DBCLARE_DYNCREATE (CDynamicControlPropPage) 
DECLARB_OLECREATE_EX ( CDy namicCont rolPropPage ) 

// Constructor 
public* 

CDynamicControlPropPage ( ) ; 

// Dialog Data 

/ / { ( AFX_DATA ( CDynamicCon t rol PropPage > 

enutn { IDD - lDD_PROPPAGB_DYNAMICCONTHOL }; 

// NOTE* - ClassWizard will add data 

members here . ... 
//} }AFX_DATA 

// Implementation 
protected i 

virtual void DoDat a Exchange (CDataExchange* pDX) r 
// DDX/DDV support 

// Message maps 
protected! 

//{ (APX_MSO (CDynamicControlPropPage) 

//NOTE - ClassWizard will add and 
remove member functions here. 

// DO NOT EDIT what you see In these 
blocks of generated code I 
//} }APX_MSQ 
DECLARB_MESSAGB_MAP ( ) 

}; 

// { {AFX_INSERT_LOCATION} } 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. . 
Hendif // 

Idef ined(AFX_DYNAMICCONTROLPPG_H EC296EP6_836C_1].D1_A868_00 

60083A274 2 INCLUDED) 



DynamicControlPpg. epp 

// DynamicControlPpg. epp i Implementation of the 
CDynamicControlPropPage property page class. 

Hinclude "stdafx.h" 
Hinclude "DynamicControl .h" 
Hinclude "DynamicCont rolPpg . h" 

Hifdef _DEBUG 

H define new DEBUG_NEW 

Hundef THIS_FILE ~ 

static char THIS FILE [] - PILE ; 

Hendif 

I MPLEMENTDYNCREATE ( CDy namicCont rol Prop Page, 
COlePropertyPage) 

/////////////////////////////////////////////////7//////// 
// Message map 

BEG IN_MESSAGE_MAP (CDynamicControlPropPage. COlePropertyPage) 
// { ( AFX_MSG_MAP (CDynamicControlPropPage) 
// NOTE - ClassWizard will add and remove message 

map entries 

// DO NOT EDIT what you see in these blocks of 
generated code t 

//} )AFX_MSG_MAP 
END_MESSAGE_MAP() 

UltlUtU/UUlUUltlUlUU/lllllllUUll/UltlUlUlU 
II Initialize class factory and guid 

lMPLENENT_OLECREATB__EX (CDynamicControlPropPage,, 
" DYNAMICCONTROL . DynamicControl Prop Page . 1 " , 

Oxec296ee7, 0x836c. oxildi, 0xa8, 0x68, o, 0x60, 
0x8, 0x3a, 0x27. 0x42) 
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intuitu intuitu// tin tin tint tuititttnuiuuuit 
it 

CDy namicCont rol PropPage i t CDynamicControlPropPage Factory i ttlpd 
ateRegistry - 

// Adds or removes system registry entries for 
CDynamicControlPropPage 

BOOL 

CDynamicControlPropPage i • CDy namicCont col Prop Page Factory i tUpd 

ateRegistry (BOOL bRegister) 

{ 

if (bRegister) 

return 

AfxOleRegisterPropertyPageClass (AfxGetlnstanceHandle () , 

ra_clsid, 

IDS_DYNAMICCONTROL_PPG) / 
else 

return Af xOleUnregisterClass (m_clsid, 

NULL) ; 

} 

tuuululuu/luultuuuuntllulfun llltutlutult 

// CDynamicControlPropPage* i CDynamicControlPropPage - 
Constructor 

CDynamicControlPropPage i i CDy namicCont rol Prop Page ( ) t 

COlePropertyPage ( IDD, 
IDS DYNAMICCONTROL PPG CAPTION) 
( 

/ / { { AFX_DATA_I NIT ( CDy n ami cCont rolP r op Page ) 

// NOTE i ClassWizard will add member 
initialization here 

// DO NOT EDIT what you see in these blocks of 
generated code I 

/ / ) ) A FX_DATA_ I N I T 

} 

ut tuuu mint iiutuu tint uittiuuut/tuuuiuuit 

U CDynamicControlPropPage* i DoDat aExchange - Moves data 
between page and properties 

void CDynamicControlPropPage 1 1 DoDataBxchange (CDataExchange* 

pDX) 

{ 

/ / { {AFX_DATA_MAP (CDynamicControlPropPage) 

// NOTE* ClassWizard will add DDP, DDX, and DDV 

calls here 

// DO NOT EDIT what you see in these blocks o£ 
generated code I 

/ / } } A FX_D ATA_MA P 
DDP_Po8tProcessing (pDX) / 

) 

itttuttuiutiittiutuittiunttuuuuiu/uu 

U CDynamicControlPropPage message handlers 



DynamicForces.h 
/♦***•* 

* FeelControl 

* (c) 1997 Immersion Corporation 

* FILE 

* FeelForces.h . 
* DESCRIPTION 

* Provide methods for doing force-feedback with the 
ForceClasses, giving the FeelControl some guts... 

*/ 

Hifndef FEELFORCBS_H 

((.define FEELFORCES_H . 

BOOL FeelSetupt H INSTANCE hlnat, HWND hWnd ) 
BOOL FeelCleanup( void ) ; 

long FeelBeginForce ( long Xdir, long Ydir, long Mag ); 
long FeelEndForce ( void ) ,- 

long FeelBeginBall ( void ); 
long FeelEndBalK void )/ 

long FeelChangeBallLocation( long left, long top ); 

long FeelBeginSpring ( long top ); 

long PeelEndSpring( void ); 

long FeelSetSpring( long springK ); 

long FeelBeginNerf ( void }; 
long FeelEndNerf ( void ) / 

long FeelChangeNerf Rect ( long left, long top, long width, 
long height ) / 

lor\g FeelPop( void ); 

Hendif FEELFORCESJI 



DynamicForces.cpp 

/*** 

* FeelControl 

* (c) 1997-1998 Immersion Corporation 
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* PILE 

* PeelForcea.cpp 

* DESCRIPTION 

* . Provide methods for doing f orce- feedback 
with the PorceClasaea. giving the DynamicCont rol aome 

guta , . . 



(I include 
ti include 
f) include 
fUncluda 
^include 
ainclude 
8 include 
^include 
flinclude 
^include 
Dinclude 
(J include 



"Btdafx.h* 1 
"OynainicForcea -h" 
■ ForcePeeli tMouae . h 
"ForceEff ect .h" 
"ForcePer iodic . h" 
■ ForceDamper . h" 
"ForceEllipse.h" 
•ForceCondition. h" 
"ForceConatant .h" 
"ForceEncloaure. h" 
■ ForceSpr ing . h" 
<stdio.h> 



gMouBe 



// GLOBAL VARIABLES 
CPor ceFee 1 i tMouae * 
CForceConotant * 
CForceEllipoe* 
CForceSpring* 
CForcePeriodic* 
CForcePeriodic * 
CForceEllipoe* 



4 Global e for our paramo 
*/ 

// Balll.gif ia 100x100 
ft define BALL_IMAGE HEIGHT 
8 define BALL~IMAGE~WIDTH 

8 de f i n e ball_mal l_w i dth 

If define BALL_STI FFNESS 

{(define HER PRIMAGE HEIGHT 
8 define NERF~IMAGE~WIDTH 
8 define N ER P — W ALL_W I DTH 
8 define NERF_STI FFNESS 



- NULL,* 

gPorce 

gBall 

gSpring 

gPopl 

gPop2 

gNerf 



100 
100 



. NULL; 

- NULL, 
NULL; 

m NULL; 

- NULL; 

- NULL; 



100 
100 



// Updown pop 

fi define POPl_DURATION 

8define POP1_PERIOD 

8 define P0P1_MAGNITUDE 

conat POINT POPl_DIRECTION = { 0. 



1 h 



( BALL_ IMAGE_W I DTH/ 4 ) 
(8000) 



( NER F_ 1MAGE_W I DTH/ 4 ) 
(BOOOT 



3 00 
468 
10000 



// LeEtright pop 

tldefine POP2J3URATION 3 00 

8define POP2_PERIOD 242 
8 define P0P2_MAGNITUDE 4 000 

const POINT POP2_DIRECTION - { 1. 1 } ; 

BOOL FeelSetup< HINSTANCE hlnst, HWND hWnd ) 
{ 

BOOL Buccees; 

RECT ballRect = { o, 0, BA LL_ 1 MAGE_H EIGHT, 

BALL_IMAGE_W I DTH } ; 

RECT nerfRect - { 0. 0, NERF_IMAGE_HBIGHT, 

NERF_IMAGB_W1DTH }; 

// Set up the Mouse 

gMouse - new CForceFeelitMouse ( ) ; 

if ( I gMouse ) goto FS_Err; 

Ducceoa « gMouae - > Inibia 1 i ze ( hlnst, hWnd ); 
if { r auccese ) goto FS_Err; 

// Set up the Force 

gPorce » new CForceConatant ( ) / 

if (I gForce > goto FS_Brr; 

auccese - gForce- >Initialixe (gMouse) ; 

if ( ! success ) goto FS_Err; 

// Set up the Ball 
gBall - new CForceEllipae ( ) ; 
if ( ! gBall ) goto FS_Err; 
Buccess - gBall- initialize ( 

gMouse, 

SballRect, 

. BALL_ST I FFNESS, 
// PORCE_ELL I PSE_DEFAULT_STI FFNESS , 
BALL_WALL WIDTH, 

FORCE_ELLIPSE DEFAULT_SATURATIOH. 
FEELIT_FST1FF OUTBOUNDANYWALL . 
FORCE ELL I PS E~DE FAULT_CL I P P I NG_M AS K , 
NULL 



); 
if 



( ! success ) goto FSJErr; 



// Set up the Spring 
gSpring - new CForceSpring () ; 
if .( ! gSpring ) goto FS_Err ; 
success - gSpring- >initiali se ( 

gMouse, 

10000, 

/ / FORCE_S PR I NC_DEFAULT_ST I FFNESS, 

FORCEPS PR I NO_DBFAULT_S ATURAT 1 ON . 
0, 

//PORCE_SPRING_DEPAULT_DBADBAND, 



) ; 
if 



F0RCE_EPFBCT_AXI8 Y , 

FORCB_SPR I NG__DE P AU LT_C ENTER_ POINT 

( I success ) goto FS_Err» 



// Set up the Nerf 
gNerf « new CForceEllipae () ; 
if ( I gNerf ) goto PS_Err; 
success - gNerf ->I nit ialize ( 

gMouse, 

(nerfRect, 

-NBRP_ST I FFNESS, 
//FORCE_ELLIP8E_DBFAULT_ST I FFNESS, 

NERF_WALL_W I DTH , 

FORCE ELL I PSB_DEFAuXT_SATURATI ON , 
FEEL IT_FST I FP~OUTBOUNDANy WALL, 
FORCE_ELLI PS E__DE PAULT^CL I PP 1 N0_MASK, 
NULL 

); 

if ( I success ) goto FS__Err; 
// Set up the Popfll 

gPopl - new CForcePeriodic (GUJD^Peelit^Square) / 
if ( I gPopl ) goto FS_Err; 
success - gPopl->Initialiro ( 
gMouse, 

POP2_MAGNITUDB, 

POP2_PER10D, 

POP2_DURAT!ON, 

POP2_DIRECTI0N.X, 
POP2_DIRECTI0N.y. 
FORCE_PERIODIC_DEFAULT_OFPSBT, 
FORCE^PERIODIC^DEFAULT^PHASE 
) t 

if ( ! success ) goto FS_Err; 
// Set up the Popfl2 

gPop2 » new CForcePeriodic (GUlD_Feelit_Square) ; 
if ( 1 gPop2 ) goto FS_Err; 
euccesB » gPop2->Initialize( 
gMouse, 

POP3J4AGNITUDB, 

POP2_PERIOD, 

POP2_DURATION, 

POP2_DIRECTI0N.x, 

POP2_D I R ECT I ON . y , 
FORCE_PERIODlC_DEPAULT_OPFSET, 
FORCE PERIODIC_DEPAULT_PHASE 

); 

if ( I success ) goto FS_Err; 

// We're okay I 
return TRUE/ 



let * s cleanup and 



FS_Err i 

// There were some probleroa. 
declare ourselves dead! 

FeelCleanupO ; 
return FALSE; 

) 

BOOL FeelCleanup( void ) 

if ( gForce ) { gForce - »Stop <) ; delete 

gForce; gForce - NULL; ) . 

if ( gBall ) { gBall->Stop() ; delete 
gBall; gBall « NULL; ) 

if ( gSpring ) { gSpring->Stop() ; delete 

gSpring; gSpring - NULL; ) 

if { gNerf ) { gNerf ->Stop() ; delete 
gNerf « NULL; ) 



gNerf; 



} 



if ( gPopl ) 

delete gPopl; gPopl 
if ( gPop2 } 

delete gPop2; gPop2 

if ( gMouse ) { 

delete gMouse; 
return TRUE; 



{ gPopl- >Stop () ; 
» NULL; ) 
{ gpopa- >Stop ( ) ; 
- NULL; } 

gMouse - NULL; } 



void FeelEndAllEf f ects ( void ) 
{ 



if ( gForce ) gPorce- >Stop() ; 

if ( gBall ) gBall->Stop() ; 

if ( gSpring J gSpring- >Stop () ; 

if ( gNerf ) gNerf ->Stop () ; 

if ( gPopl ) gPopl->Stop() ; 

if ( gPop2 ) gPop2->Stop() ; 



long FeelBeginBall ( void ) 
{ 

if ( gBall ) 

{ return gBall- >Start () ; 
} 

return 0; 

) 

long FeelEndBall ( void ) 



( 



if ( gBall ) 

return gBall - >Stop () ; 

return 0; 
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long 
{ 



long 



FeelChangeBallLocation ( Long left, long top ) 

if ( gBall ) 
{ 

RBCT r; 

t.top - Cop; 

r.left - left; 

r. right - left + BAliL»_I MAGE__W I DTH \ 
r. bottom « top + BAL,L~lMAGEJtSIGHT; 
return gBall->SetRect ( tr >/ 

) 

return 0; 



FeelBeginForcel long Xdlr, long Ydlr, long Mag ) 



If ( gForce ) 
{ 



, g Force - >ChangeParame te ra ( 
Xdlr, 

Ydlr, 

FORCE_EPFECT_DONT_CUANGE , 
Mag 

); 

return gForce - >Start () \ 



long 



long 
{ 



return 0; 



PeelEndForcet void ) 

if ( gForce ) 

return gForce->Stop () ; 

return 0; 



FeelBeginSpringt long top ) 

if ( gSpring ) 
{ 

POINT pt - {O.top}; 
gSpring ->ChangeParameters ( 
Pt 

) i 

return gSpring->Start ( ) ; 

) 

return 0; 



long 
( 



long 
I 



FeelEndSpring ( void ) 

if ( gSpring ) 

return gSpring- >Stop {) / 

return 0; 



FeelSetSpring ( long springK ) 

if ( gSpring ) 

return gSpring- >ChangeParameters { 

FORCE_E FFECT_DONT_CHANG E_PO I NT , 
springK, 

FORCE_EFFECT_D0NT_CHANGE , 
FORCE_EFFECT_D0NT_CHANG E , 
FORCE EFFECT*" D0NT_CHANGE 



return 0; 



long FeelBeginNerf ( void ) 
( 



long 
{ 



) 

long 
long 
{ 



if ( gNerf ) 

{ return gNerf- >Start () ; 
} 

return 0; 



FeelEndNerf( void ) 

if ( gNerf ) 

return gNer£-»Stop ( ) ; 

return 0; 



FeelChangeNerfRect ( long left, long top, long width, 
height ) 

if ( gNerf ) 
{ 

RECT r; 

r.top - top; 

r.left - left; 

r. right - left + width; 

r. bottom « top ♦ height; 

return gNerf - >SetRect ( &r ); 

) 

return 0; 



f 



long PeelPop( void ) 
{ 



if ( gPopl ) 

yPopl->Start ( ) ; 
if ( gPop2 ) 

gPop2 - >Start () ; 

return 1; 



Resource.h 

/ / { ( NOJDEPENDENCI BS } ) 

// Microsoft Visual C++ generated include file 

// Used by DynamicControl . rc 

// 

fj define I DS_D YNAM I CCONTROL 1 
\\ define I DS_D YN AM I CCOirrROL_P PG 2 

B define IDS_DYNAMICC0NTR0L_PPG_CAPT10N 200 

tf define I D D_P RO P PAGE_D YNAM 1 CCOHTRO L 300 

tt define lDD_ABOuTB0X_DYNAMl CCONTROL 1 

ft define IDB_DYNAMICCONTROL 1 

fl define IDI_ABOUTDLL 1 

ttdef ine _APS_NEXT_RESOURCE_VALUB 201 

H define _APS_NEXT_CONTROL_VALUE 201 

H define _APS_NEXT_SYMED_VALUE 101 

Bdefine APS_NEXT_COMMAND_VALUB 32768 



StdAfx.h 
»if 

Idef ined (AFX_STDAFX_H EC2 96EEA_836CJUDl_A8 68_J)Q600a3A2742 <L 

_INCLUD£D_) 

« define 

AFX STDAFX H EC296EEA 836C 11D1 A868 00600B3A2742 INCLUDED 



»if _MSC_VER » = 1000 
^pragma once 

ttendif // _MSC_VER >» 1000 

// Btdafx.h i include file for standard system include 
files, 

// or project specific Include files that are used 

frequently, 

// but are changed infrequently 



fide fine VC_EXTRALEAN 
Windows headers 



ftinclude <afxctl.h> 
Controls 



// Exclude rarely-used stuff from 
// MFC support for ActiveX 



// Delete the two includes below if you do not wish to use 
the MFC 

// database classes 

^include <a£xdb.h> // HFC database 

classes 

» include <afxdao.h> // MFC DAO database 

classes 

// { {AFX_INSERT_LOCATION} } ■ 

// Microsoft Developer Studio will insert additional 
declarations immediately before the previous line. 

ttendif // 

Idef ined (AFX_STDAFXJ* BC296EEA_836C_llDl_AB68_O060O8 3A2742_ 

INCLUDED J 



StdAfx.cpp 

// stdafx.cpp t source file that includes just: the standard 
includes 

// atdafx.pch wili be the pre-compiled header 

// stdafx.obj will contain the pre-compiled type information 



((include "Btdafx.h" 
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